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Preface 



The AppSe liCS ProDOS 16 ffeJifT^lKf Is -l maiuaa] Tof software 
ilevelopcrTi, adi-ancKl pjGBnminen, antl o^ers vhn wish ^a- 
uftLtefturwl. [he lechnJcai JSfiecLi of iJie AppOe IIC-&™ cperaUng 
sj-Ucm. In pulicuiar, ihts mWH)*l wjU he aMful id vqu if ynu warn !□ 
wr'lc 

D 1. slind-alDnc program thl.l JUtomstlnLlv rurts whpr the 
comjxiler J» started up 

D a n3u[i[K ihii C£[3lQgs dijk;, nianipuUtcs sparse riles, or 

otherwise LraERcns wtih the Applt lies ffe sysicni ai a bask level 

n in liiif^ntpt haruilFij' 

D i pivffiia ihii. \*33iis and runs oOim pro^aiim 

n iny presmm mslng SCgrn^ntcd, dynamii: okIc 

Tlie Fij.ni^JCtU ^nd caJk In 0~iu msjiuj] arc in afscmtply n.n|^A^ 
fQimaL IF you ire proEramming In ilSJemblv lajinuagc, jiou may use 
ihe Mttie fnfmac l-n icass opcraiing aysiem feaiuits. If you aro 
pmiHrammirig ]n a hghcr-level Eflf^glia^ for if youf isfiemblsj' 
Jneludcfl a. PiciDOS* ]i5 nacnt Lib.my), y-cu wl![ use libncy Jnterfaea 
rnu[[nca spcCtriP EO yOUT laligUigis. Tlifisc librajy toulinea art noL 
dfscdbcd. hiifr, rnruLil'L ynur lingui^gc MdnuaJ. 
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to the Apple fiGS technical 




Th« Apple UCS pciwjnal i:D[n.pLilii:[ his nLany a.^vince*i ft-mirVi, 
makinB it culotc 'coniplejt -diaji ■eailiijr tiTOdeb d" the Appte* H. To 
describe It fully, Apple tiis praduced a ^uita rif lectinJcal tnanuab. 
Depending an the wav you inreod LO uie [tK Apple IIOS, you miy 
need It) refe» 10 1 select few -af ihe mimjals, ot you. rrt»y need ru refer 
[Q must af ttbem. 




Tlie lechrtlcal fisatiuaLs ue liitrd tnTable P-]. Fibuki p.] is a 
tliagrant siiDwin^ ttw reLidi>nship5 Inion^ the different nunujls. 
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How to use this manual 

The Ajp!^ /Jtis' PreDCK 16 /fefurvncfi Ij bcKti s. wta-ence marmal 
and a kitming rniiL. ii 1$ divLded Jnlc H:<'ic[al pails, [o help fiM 
quickly fmd wfai ywj need. 
3 Fan I d»cfib« HnjDOfi 16. the cmfrat pan of the Apple lies 

□ Pan n tbis and exHains Ihe PirfXiS 16 upmatinB systera caTIi 

D Pan HE describes the Syilem Loader and HSB l]l loader caJb 

□ The final pare tynslm of sppcndlics, i ^ossaiy. aivd aji LjtaIcs 

the iitsi irhDipbBr Jn ea.di pait is dnCnxlutlcn~y- jcid il fiiUC if yo J 9W 
Mft jlreiJv familiar wlih the wbieo- The icraaining diapurs at 
prlmiflly for itfcrcncc, and reed ruH l» read in arts' [urticulii 
nrder. The PmDOS J6 Ewrefccr, on a. pdtoJseiie induded with the 
cnai^al. pirOwid£9 a way tc praoice mahLnf PicDOS id' calisi btiftM^ 
ctuBllr oxLing iJiem 

Tlilfl nianuil does nm eicplaln iliCiili as^^embty lar^^^. Rcfcir [□ 
j^pp/e Wci f^T^nammari 1F(«*i-fti>p AJKmWtn- fle/vrvnt^g Fpt 
iufDrmaiion on Api^e IHns iMcmbly ImguaBc proBunMnlng. 

Tills manual does- nm give a deiailed tlesciipiimi of PioDOS H, ihe 
A pple IJ tipenlLna ^yUicm from whJdi ProTXJS 16 was dfertved, Far a 
synopsis i>f [be dilTerefices between ?f qEMS 8 and PraDGS l6, *ee 
Chapirr 1 of i}m manual. Pot mate d^'iaJIed. Jnliuniadan, on 

PraDOS &, sec PreHtOS 8 TBi^nKfl/ RS/CtertCJi Manual. 



Ta U3C Lhc ptOduCU descnised in rhL^ mmuil, yrai wd] need an 
A[ipl(? IIG5 with II Icasl cnc ciicmil titsk drivt tApple recfimmcnds 
Cwo tlnvcij PrortOS iS >jnd. ttu^ System Loader requjrc only [he 
muilrnuin racmory ctmJlgucllJcm {256K RAfcC, al'hrjufth Appi*^ liCJ^ 
P;ogranillker'j WcniLsEinp Jjid many appLiLallm pmgranu may 
require more mcmcirv' 



You, wiU aha need in AppCe TtOS sjTtem disk, A system cUst ccmtaini 
ProDOS 1ft, PtoEJOS S, ihc SysScrn Loader, and oLhci srSWtn 

sorrware; iie«ss«y foe proper ruficcioning of ihc compntpr. A 
syilcm disk oiay ibu cciclUItl ipplifi.li-DQ prt>grA[Tli, 

If you wisJi i^ practice maldni ITodOS 5^ tiperaLin^ system lbUs yuu 
wHi fuxd lAc PiaDOS Ic Exirrciisr. a prugram tin [he diskette 
induded ^iih dua manuil. 




Publications 

This mitiiiil is [he onJy [cEcicno: [oc ProDOS 16 ifid (tie System 
Ij3idei, Van miy ITiid, u^tilul rdaicd infannalJan Ln any cE ihe 
lAiblLcaiions Itsisd jndei "HoadnrHp lo Apple crcs Tcthnita] 
Maii'uj1£' ill [his preface; in pajtioiSar, yc^j may wjah [Q refer to the 

folio Wittg; 

■ Hic i^hni^al IhtroditalO'tik The KKAnicfl/ /h/hm^nwi /o 

she AfyfA^ IScJS ls fhc riral l^nnlf Ln Ihir suilc of IccKnical mailuala 
abcju-i [he Appl« I IGS. Ii lits'^'^x-'i all aspccLi oT the Appic lies, 
including i[s fciturcs and .gcncial dciiign, [he prO£ia;nl 
CJiuiroiiiiiejiii, iht i^ialbaR, and ihc dtnTlapinent rjiviranmcjiL 

■ The prDyrainiiii^r'!^ tniroductlDn; Vhi^n ynu sun wnttng 
programs far ihe Apple l\C& , [he Frofirumm^'s iTUroducifffn to 
the Apple Has jMOvide* che concepts and guidelines you reed, ii 
35. a, 5ta.Eling point for pTagrainmcrs ■WiTiling eveflt -driven, and 

GcgincnccHl applications tha,t use routines m ihe Ap|)|iii llCS 

TGnlbDS. 

■ The flfmw^J'f T^ftfCQ'^ mainualE TTv^ Appie BCS FiTmUiiiTe 

RefarenCS dcsoibcs die loulinea dia! art HOiei irt the machine's 
read-ijnly memofy O'OSCi 'I Includes inTormaticn ibcui 
iiiLcrnjpL ratitineS and Itrw-lcveL I.*0 iubn^june* fOf (he serial 
ports and dLsii pan. The y^iTnuuPB' Se/eresice alsu dcHxilXi [He 
MtjnJiHjT. a luw-level prdgramminjj iind nJebugging M if 
iSsettiMy isngua^i: prn^ramA. 

■ Ttie loolboK manuals: Like the MsciniMh™, iJie Apple iig5 has 
a huilt-in wnlbcu. Thic two vnlumes of ihn A^pli IIGS TOOibOX 
flffCI-enCS hWOdUCe concepts l nd tcrniLnolojty, show how Lo Ti3C 
the ttxils, and tclL l^w to wii[c and inala!! yOui owrt [cjol sei. They 
sLji.i clciK'ibv th« workiJiKS {ifsncne a! Ihc ^'stcm-lcvcd Icfol sets, 
Euch 4s ihe Memory maiu^r, ihit Inumcc difwliv »>|h proEX^S 
IS and Lhc System. Loadec. 



Tlie Proip^ininlWa Wnrkshop manuils: Tht dcvdcpmeot 
^jivlronmtrn fin lhc AppJe I1&5 fi tin; Apple ms pKigrammcrt 

Wcirfcshop tAP^'^. APW Is a sel of progrtms Ihat enabUi ynu Do 
create and dcbu.B a ppLiolion pfofimns ™> the Apple [IfiS. The 
Apple nOS yreKrdmmert lFoTteft(i/i Re/ET^ce indudca 
inTcininatiDn abovi Uie parLH flflhc woikjhnp daat are 
independent cF ptORramming l^nsuage: die s\^\, the «flp»-. the 
linker, the detuggcr, iHd the uiglltiv;^. tn addilion, ificrc is a 
jgpajate lefcntnce manual Tor cadi proRTammtng tanHuage- "iTie 
nHiSUji-i fm (he IjAjpiai^y Apfile provide* are Lhc AppS^ Has 
Pmgmmmsr'i in^taftcf AuCTPtWe^ Jto/prmw and di= ^ft(ite 
AGS PrKgrsmmsTi BTiftiAc* C fls/ereii«. 
The JWJDOS B maiujaL FruDOS 8 [pfcnOuSly called juill 
/^^nOQi') is compMihSc wi* all Apple II campure-tfi, Incjjdinu ihe 
Apple Ilea.. KA i develDpei nl Apple JIO^ pf QgranW. V«u may 
need to refer lo tiM i'roDOS S 'fttJiHtaiJ Fe}erpncc Mitaual \1 
you arc develnjurB; ppugwms to run on s-tandanJ Apple II'b li 
wel] as nn the Apple llC^, Of if VO" ajc convening " ProftOS 6- 
bi»c(J ptogfim, to twin -under PiolXiS 16. 



Notonons and conventions 

To hdp make tiW! manual more wndcralandible, lhc (bllowina 
conve-ftdon* and deJifiiUons apply iliroogtiouL 



Terminology 

Thu milftual may tlefine iKstain ternti, ajch as Apple II and 

PIODOS, slighllT diJIcrcndy (h»n whal you are used to. Ple*5C noie: 

■ Apple H: a fioncrai njffeiwnce to the Al»ple It tamiliy ai 
CCMnputcrs. eapeOaily Ihoac ihil may use PrortO.S S or PtoIXK 

liG as -an npcrating System It LndLiilM. Ovi 64k Apple II Ptua, the 
Apple He, llu'! Apple He, ami itie Apple IIGS. 

■ nandJtrdi Appk [L Any Apple IE najripuier ihai is ikm an Appl« 
iI(S. Since previous membprs cA the Apj'ile n family »lta«: many 
durifacrisuca. il iS uscfji [fj liWInSLilah Liicnl *fl a group from Ihe 
Apple lies, A ^vlandard. Apple H may also be ^Ited Jn 8-hUAppls 
SI. because of [he B-tiiL rcgiaier^; in iis 6502 or 65C02 
mLCiOplOcessor. 



FroDOS: A Renera[ lenn (^csibjng die limdi]^ of cpcrjlifig 

sysasna devrbped feat Apple tr compuKfi. li indudeis bah 
PjtjCOB H ind PfoUOs l6-. it doss not Indude FXJS 3 3 or SOS 

PtnDOS e« Tlic B-3jIi PratKJS uper^ng aystem, Ihmugli version 
1,2, onginally developed for waddlrd Apptc n <i>Tnputcis Ehjc 
tompaUTiki with ihc Apple nr.ft. [n pifvluu Apple Q 

dnajmetiiaiion, ProrOS B is called sHttipJy PmOaS- 

PcvDDS 16: A Jfi-bll opcratim^ syMcm developed for the Apple 

UGS uJtnpuEcr II is Ihe syaLcm dcsofijed In, [his nujiui]. 





Typographic convenrioflt 

Each new lenn inliotijiajd tn this minuil ix printed run in boM 
type. TtiiL lets v™ Iffjow ihai the Derm hss not h«n Jcfincd c^idier. 
aftd Also JjidJLuuK \h3.1 there 15 4I1I cnliy for il irt ihe ^ossaiy 

Assembly Ungu^ge laheb, emliv polnu, nniUnc cimiwa, *nd (ih: 
rum« [hit ip^Knr iji [tfjii piKajjes, are pniKcd ui j spcciii tiTieTaee 
(for: eiamplc, naiM_length afld Get_emthv). FimctJmi names 
ihal ire Engjish lanpu^ Wnm irc fu-iru^d wilh jjur^irl caps (toe 
cxampte. Load ScRmesn By Nnmlwrl When the name of a labo] or 
i^Hable is u&ed I13 mean ihc value tifttat vjriabfc lidci ilajn in 
name, (hi; wH^ird LS printed rn itaiia fftx eianiplc, 'Jjt fint 
iwwi(.'_ifniy^ l>Vie5 uf this Si^td conuin the volume name.. '5_ 



Watch for lh9S« 

Thet Eollowtn^g wnrds nurk jpcdal mesaagea ta you 

♦ Wate Test set olT m iho manncf ^.i»,nih 1 word o. phrase srjiih m 
fltods ™ Jy ihp (Wfj^prcwjlti sidelietus or inlctcstinn poinia oiT 
atoinmmn. 



Tsm BBt off In IH3. rmonnw— with ttia word fmiportrmt 
Imiwrtanl In/oimotle*! or irelnjcMof!*, 



p*Bsenti 



Twrt est off In W* iwirviBf-wiff< [he word WomlBgi -Ifriion+w 



Part I 



How ProDOS 16 Works 



Tila pifl Qf !he majiua] fljnes ? g^nerjl desotptioti o[PrDlX>S 16. 
FraDCS t6 U [tw dlak; opeming systrm roi die Apple nc;&; li 
pjovidKS file manaEcrneni and inpui-'nutfUJl capititlilies, and 
controls. cermLn other ^'ipei^i,') r^f cht fippk l\Qi Crp^raUng 
cnvtron men t. 




About ProDOS 16 



This chapter introdui::e» ProDOS 16. Il sivca bickg«miwl 
InrocmallOJi on Uic dcvdopmcm af FnjRO^ 1&, fall<wed ty an 
cwvicw of PrtDOS 16 in rclaiitm ri> ihc Apple Hos. A brtef 
tcmpartSOO of ProDOS 1fi with Pral>OS Bs Jts, ttosCM wiativc [rt [hc 
Apple II wuflt, iS follnwcd by i jcfercnce lisi nf the cnMI perrincnl 
FroPOS 15 fciLuit.4. 

Th,e i±aplcj-'£ ofsaninUon nSugWy parallels LhJI oE Pirt J as 1 
whole- Hach section tertjs you to [he appfopriair diapter (or more 
LCifDrmatlon Od eitii aspctl t>( FmDOS 16, 



Background 

TTw AipTJle lies if Ihc Ittew Apple I] computef. ]iB TTiicropir>i;ES5D[, 
the 6K8I'6, ia a suwcssot co dw iw ndard Apphf lis' 650Z and; 
ftmctkin! in both S-h<t t6502 craiilatkin? mods Jfld Ifi-bit tiiaXiviO' 
mode (Me T^itrHcal /rifmrfucrturt ;fl !fte .i^ple naSi. in 
dceMdancc wilh ihe dieA\gn phJcsupliy aovcmLng all Apptc II 
Eimily ptodjcts, [ht A-ppIc Hcjs U tonipa!i"bl<? wish siandafd 
Appfc n softwstc— most presemly aviilaMc Appk It, Apple nc, 
and Apple nc IppUcsUona will lun ("dthout madificaliOfl on the 
Apple lies. 

To main ihis {i.iftipatfhi]lly while aikHaiS bcv,- fe-jlureS, tht 

Apple HLH requires two scparlLc opecllins systems, PionOfi a 

ami Fri>DO& it 

a PjqDOS 8 IS iJie operating ivsiem Tar jtanJ^rd Apple 11 

ccunpijicrs. The Appte HGS usw PlnDOS S and puis, ihc pra«S*0* 
inio cmuSatiDn moJe >" cifdcr to mn stainiajd-Apple II 
appll«il<iiis, 

Q PraDOS l6 \i a ncwli' dcvrLoperf sifWcm; i[ tzhe^f advana^t Of 
Apple llGS rcjtun^-S ihai slindard Apple If romputciS do nol 
haw Tie Apple ]lt,S uses f'rnI>CJS 16 and pilis the pracrssOf Ijita 
native rrvwic in unjer W tun Apple IIGS appliciliOflJ. 



Pari' I: Hdw ProDi^S 14 Worta 



The user need noi WDiiy aboifl which opcrtling syit«im is acU™ ar 
aJiy Mc time. micncvGr [h* Apple JIKS loidr: an spptication, Jt 
JUEamatially lead.? iJie tsapci opunUns syfaum fai jl 

PraDOS 8 on the Apple HGS fwDOiDrts Identically la Pn^DOS E an 
□the( AppJr U tomputcrs, Por a rampaeie dcscfipUon of PcdDOS 8, 
see PmDOS S TedinitMt Referwice Manaai, 



WhCfTlsPfoDOS 16? 

PjqDOS 16 is tfK lerilral pan, I.H kcmct, ;»r the Apple l[G5 
«peralinfi .lysitm. Alihotigli qUei softwan: enmpcncnts Uuchi as tlffi 
Syacm Loatfct rfc*<afl)cd [n, thu inaruit) miy be thcufthi oP as pifis 
qE Oie avr^nai uptnOng *ysiem. PidDOS 1i5 is the tity comiKinent K 
rnanaaci tbc ocjlinn and mDdiflrtCiCin of files. |[ acce&s&s [he disk 
dcrtces tm whidi ihff fiks afe sHw ed and n^tricwd. ,1 [ dLspjuiea. 
inMiTupt sisals la loterrupt tuuidbm [r iku tantrt.ls certaJn 
i-iprcts or Jc Apple UGi npcilttns rns'ireruiiiiRr, juch is patflrume 
prefHcs iDd proccdurea for quitting pragtams ird stilling new 



PfOgramming levels In trte Appte lies 

Ftaurri 1-1 K a SimpUiJed |c^£ia] disjfram 4>f the Apple JIGS, from i 
prOgramnier's pa.nr of i-icw. Ruitw repfe&snLinB pita of ihe ayfliem 
form t iTrtiol tiicraniiv, iriDWS hctwft-n the boxes shaw iJie ftuw dI 
ooflunl or exCaiiiQn from Doc. level: [□ rhe (lerL Ai \hs lilgliesi level 
is Ifw pruarammeF ur liscj-, he dfreOly' minipuLstej Ltle cjaecutlort of 
[he appJjcaliHjn pnjeram thai mm on ihc niad^ne. The 
ipplicjdoo, .n turn, inieraos dirtcUy -with iJic nc-jrt Jowtr level nf 
SnFtw*rt-^hc tjperatmjj SKMcra. The opciitLig syMem inKMm wilh 
Ihe "try iDweat level oF software ir ihc machine: [Jie hiill[.in 
Himwaje Hid tnnlbiii rouilnes. Those rMJiines direnly manlpulite 
the s.win±es, regiiicra., ami Lnpui/ouipuL deviec* that mfiHiiucc this 
compuicf's liintwsje. 



Chapter ]; About ProDos 1* 
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PrograniTJng l«vetj In tfw Apple KS 

This hienicMal view shows ttul tite t>pctailn|{ syrtcm sS S" 
inktmcdiarv bdwctn (he appLicaioji ptD^arn and the <:ampuicr 
hanlwa(¥ A pfOBrsm need noi Unnw ihe deiaik of uniiiidLjal 
haidwaic tlcvites Ll acccEca-, insUaJ, K makes opcraling syslcm 
cUls. ilic nper^Iing ayaieni then iranslaies ltnj»e calls into ihe 
pnupci itKlTOiOioi^'' far T^hatevrr devices aie canncat4 W ihc 

The lowesi soFtwatc Level, between ihe npoating sysltnii and 
hanlnuc, ls cxten*iw>ly developed ir lilt Apfic [JC5. 11 curWi^iS nf 
iwo rarts: ihc- flr ui w Jf e. a collection nf tiaditidriiil ROM-based 
[OutJnes fi;" pcrronmina suth Ui^J J* ciiaia.rter l/t>. iiliwnjpl 
handLing, and meniisry manipulaliai]; and \tK tnoOta-M, a Jarftc set 
uE iSSenVblv- Language roulincs ^nd maocs useful lO *ll IcvcL; of 
scrEWBiB, Asiki anaws on Fibuic M show, ProEUDS 16 JCiKHCS Ihe 
flfftlwaJt'toa^ letel of itw Appls: lies durtdy, boC so do 
jpplicaliun propams. In Mhei wunis, fv lool calls iJ»d (enain 
types of yo. appJicalltina AjpOK ProDOS l6 antt JnMtraEi dircttly 
viih kjw- level system softwaic. 



The BfTOws puinLiiJB u/juani along [he diajtram sJiiyw ■ courdciiknu 
or iflroiiiia.Lian, Jn which lowei levcLi \n [I'M: jnachinc notily JilgtKr 
Icvcla Df impi:iiUnL hu Jwais Ctmdiliuns iDtumf EB frtim 
hardiirtife tfcvia:s arc hantlleij both by nrm.wafe and by PtoEMU.S tfi; 
«v«t[B lic simihr iU imcrmpts but are harudlcd by appliflili'Jns 
[hiDugh lool alis. 




Dblcs, v(^mas, and files 

ProDos 16 comfmiJiJcaEcs wiih several di^ercm types of itiai dmcs. 
hjt ttic type of drive anJ ic^ phfsii;^ bcaHan [«Ioi or port numlxx) 

need orA be tnoiMi u a prrjjjjam iliai ^oiYls to access l)iai drive. 
Instead, i pftjgram makes aJlj m ProDOS 1<S, id*i5UFyinE '^'^ f^^ "^ 
warns [u acoiss hy ii;)^ MjAtnw name o* list.'U^ name. 

InTuniLiii™! on a voturae to dLVIal^SEl inLn tUcs. A Hte is an oidcrGd 
cnllccUofi tif bjiEs iQiai hw several aiiribuiea. induOtng i msnc uid 
a rJe type, ■Pilcs arc ciiv^ sundud Hfcs tamtainin^ any ty^M (jJ 
H>* or *iau> nr dilrHMhrr AJn Cconuinirw the nxna^ imJ H.liEl< 
IticsUoris of -tMhcr files). Whefi a -disk u LnkialEv fucmaued, its 
vohimc dlKCtnrT- File u mailed; (he voiurae dln;GU?iy has (he 
a^uc lULinc 15 ihc vnliime iLseJr 

PrnTOS ]6 suppeina a hicFaircUcnl nie (ifaicia, iDeanlng that 
volume- dlrcdodcs citi cuntiin the names uf dlhcr fOra Of av\ta 
dJicecofIca, called S|ib41r«ckirlca; subtJire-clorics in ruiYi tar 
cnAEain the njjnej uF fJes or ralfcer !iibdircclftrie,v ]t1 a hicrarchla] 
file syslEjn, a rUe ia idcntLTLcd hy iis patlhoxiae, a setjuena; of He 
namcq aarting with ihe vulumc dtreaeii^' aiwd e^dit^E wlih L^lc ramc 
orihc flit PiaLire l-Zshrjwslhc rel^ijoruliips amoflg TAtMima. 
hieiairhicjj TlJc systrm 




Ejiternal devices 

PfoOOS Ifi cftmmurtiaiea nnly wth block devices, jjueh at di-sk 
drives. PtagrArns ihat wish td lIKttii dLoradcr ^evicts such as 
pfirtWrs ind coram unicai ion porti mu-i-i di> so JLrtHnJy, c[Ltu;( 
iJlnjugh Ihc dc»ira fimiwiic m ihmygtl Apple DCs Tnolticm 
nmUnej ijKriEten fot thnse devjces. Sec 4;:^ //fff /TiwifHSFS 

Cumin deviors jcnenite inlcrmpts [<i lell ihe co-mpulci ilai the 
deirljcc need! aacna™. ProOOS lb \a able: to hsndte up lo 5 fi 
iniertuptuia dqi'ices. Ytnj may pJace an Lniemjpt-handlirijf tuuune 
irao wn'ice ihrraigh a PfoDOS 16 call; yoyr routine will then be 
calJcd each iJni^ jn inleinipi <x:cuf:!i IF yuu Install more lllan nr^ 
rciijinp, iJie Kjuiines wU be polled in the wder tn *hicJi ihcy wiae 
Jiwalled. 

Ydu nu)/ also T^jmove an inttnupt rmjlint: with a I'roDOS 16 call In 
■writinj, rAiiillms, am] pemovlrig jnicn-upi Tiindlirg routlnej, be 
Surer lu JdIIuw ih* ajrvenliana met nequLnrracnls fil-v^ti In Chapler 7. 
•AddiiiB KflwuncJ to ProDOS i6,- 



ProDOS 16 gncl ProDOS 8 

ProDOS H-i. allln^jgh ib:rlvmi Frym ProDOS fl. mjdi several 
capabilities 1Q suppon The pww fcaiures and oper^ii^g 

connsuralicms of the Apple llos. Fat Hjiiimplei 

a Drduu the il5CSlfi ml CTfi profess or Funnlijns |ji both BJill 
{EmulHican.) and ]6-hiI (naUvc) cKcoitioii jnodcs, ProDOS IS Is 
designed id accept syilrm c:al]i rrcnn ippEitition.'i nfnnrnj; in 
dihtu- 6-Wt or iS-tnt mode HioOOS 8 acc<;]»s sysicm alts ff Dm 
appUiraijtirLE runnkyj! tn 8-lirl made arA-f 

D teciLiir the Appte riGS has a tnta! addresMWe memory 3pa« of 
]l4Mb, ViiiDOS 16 has the abtllly !□ accept .^vsiem calls frorn 
anywlicm: in thai m^mnary apace faddreases up lo JFF FFFF^, and 
thftW? tails can maniputalc data anywi'llere in mamnrf Under 
PraDDS ii, sv Hem i:aLs tan be midc IJnm flietnory iddr^Ksea 
bdnu' Jmr anly— the liJWBSt 64K of tlKrtlOry. 



Cfnplvr I: About RciDob Id 



ID proOOS 16 retira tm a soptiLSticitcd mcmofy rajniBenicnt 

lysrcm Csce Chiptcr ». Insiaul oE ihe simple ftloh*! pa«& b'' ™P 
used by PiotXK a 

J ApplitatiOtVS wndcr PrtiDOS 10 must Jnahc till* io alloeaie 
motiwry at !□ atcess syslFirr global vari4tles, such « dale and 
lime, system fevcl, and I/O buffer addresses, tT»DOS S 
tnaintains that ijiformation iii the syslem i^Libal page in memciy 
tanJt JOO. bul undci PicDOS 16 Ltw Jtl4*a] pag^S is i:tc4 supponed. 

D PlcDOS 16 alM provides sewcral proarairtminE cOrtwirJenaM 
not availatjLe urutcr ]=foEXJS fi. Lndwding filmed dcvioes. and 
tnultiptc, uj«r-dellnab]e Ills pre-iuKS, 



Upward compotlblNty 

In a snifl Mrae, ProDOS 36 Is nm upwidly Mrapiliblc from 
ProlXK 3. PregfjJM wriuen to ftintUoiJ tinder ProDOS 3 en in 
Appls 1 1 will not nun on Ihc ^?ple Hcs, utt*r,fTOOas JS wiEhuul 
atmc modillauicin. ConiepluaiLy, hoativer, PnjDOS 16 is 
u^svw^V tompaiibte rrom ProDOS Fv in at leaw two wa:ys: 

1 . Ttoe iwo ijp««ating bvsijf'vis is^ ihcmifsLvcs similar di^ sinjcture: 

D The set of PfoDOS 16 syMem taJls is i superset uf llie PrcOOS 
B alls; fnr [almusO evciy PtuDOS 8 system all, Ihcrc is a 
fLmcLioniUV equivalcnl Pl-oDOS I6 call, ii*uaLlv with thr same 

D TlDe alls aie made in ftaifty idcnlical ways In lK"h ProDtB 

STBlcnw, »nd ihc pinmeicr blocks fOP passing values !□■ 

funjasniis are Is-i^ ant sLnulsriv- 
a PtoDOS 16 uses ewoly Ihe aame file syitem a* P'raDOS fl. !L 

can read from 3j]iJ wrUe ID any disk vdhinic- fifwducfflJ by 

PK1DO5 ft. 

2. Both opcialing iy5tems a^r inolLJdcd ^^■i1h ttie Apple ItCS. Motf 
applicaums wiiticij for PrnDOS ft on siandard A.ppLc II 
cntnputeES will run wEihout modification oti the Apple IICS — nol 
urHlec l^toDOS ]4. but under PrtOOS S. 
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ThuiSj ei^n ihougJi the irdivdlujil operaUng sj-stems ire not 
compleidy compatible, iheir ium an the Apple lIGs campuKLr Ij 
cumplcteJv upwardly compauble (tom other Apple II campuKii 
Vou nev« need be concefneJ mih -which Dpersting syiicm u 
functiDrujiB — ifyoi! fan an Apple n applLGnJcjji. PioEJOS B i* 
auicmiariallii loaded; if you nifi an AppJc HCs applicatloru PidDOS 
]6 is automatJoJIj' loaded ChipUa 5 exphLu ihe dctaiE; of fiow 
ItviA Is BccGinpiishfd. 



Downward cdnnpciHblltv 

PrcdXM IS 12 nnl down-aar^tl'j' comjntiUc to ProDOS S. 
ApQ]ititions aiiUcm foi PraDOS 15 will no[ run nr Lhc Apple ir. Tic. 
at lie. Th* enifa rncmDcy needed bv Apple IlG5 applJicaiJoiM and 
■he iddiliOnal iristiuaJans twugrdzeid by the li5CS36 
micro p race? so/ malte appticaiions wrineji Tcr ProDOS 16 
inencnpati'ble 'Willh Elandaid Apple 11 camputEOv 



EllmlnoiBd ProOOS 6 ayitem caSs 

As meniionBd undci "Upwaid Com pitlb nicy/ most ProDOS fl calLs 
hive funainnal.lv txan cquiiraJents lai PmDOS 16. Hcwevcr. some 
FroEJOS 8 caEis Jd not ippeif in PiaDOS 16 beciufe Uicy are 
unactMiMry. The elimLrblieJ alls m: 

asWAME The PreiDOS IS c:Hfiti3E_PATK oil perf-omy The 

f-irt\e (unction. 

Qet_tihb L'n,rfcr P«jpOS 16, lhc Umc ind date are obuJned 

lhfcu£ti J ciU Lo Lhc MLaceltjnemt! Tool Set fcee 

SET_BUr Under Prr-POS 16, the Memory Marnge;, lattief 

thin the ipplitaiitm, 4Hoi:asEs file I/Q bufTeM. 

GET_BUF This call is unne-ceKory unde^ ProDOs ifi bei^use 

the QPEW call returns a JiJndle Lo [he file's I/O 

CIK1.INE This sl] ii replaced in PfoDOS l^ W the VOLUME 

caR. 



N«w PpoDOS 1£ iyslefii colli 

The foUnMug operating SYffKtn calLi. noi lecDgnlzed bv l*rolX>Fs S, 

are part cif PfriDOS I6: 

(clears eirte of a fiitt aC(£SS bfts!! 

tdianse* the psthnamc of a file within a 

voluiDe) 

(sets lhc system file level) 

(lelurrB (he s-ystem file level) 

Crdums ihe device numbet for ■ named 

tfcvite) 

tcduTTis ihe niLtmber of the lasi device 

QtijTiEiLiJi a dilsk vqIllixi^:: 

[iccunK Lhe fiLename of lix- oiJicni 

ttppLi.tniofiJ 

trclurm the najnC Of ihC vgJuiM ihai 
efn tains ProDCK l£i 
G£T_VERSiCN trciurrta lhe oirrent PrnDQS 16 vecslon) 

These and ill ixher CrariOS 16 cms am deSCTibed iri dftELll In 
Chapters 9 through I J. 



CIEAS._BACKUP_BIT 
CHAHqE_PATH 

gET_LEVEL 
GET_LSi/EL 

e£T_lJlBT_DEV 

' GGT_HAHB 
GET BCOT VQL 
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Uk* PfoDOS 8-, PfoQOS h5 .■uappofla Mock tlevicra only. « lifVJi nat 
support I/O operations (rii lhe buHr-ln -leriai pans, mouse.. Applw 
Deskiop Bus™, sound Bcncralion system, or iiiy other nonblock 
device AppJiC^tlruu must aeocis ttiesf devices lliM^Ugh lhe device 
CnxLWiic or lhc- Apple IICJ Toolbox. 

PtoIX)!) fi afid Pr(irX>^ 16 haire IdrmllCal file SlruCtuttS. Each ob 
n^ad the ciLlicrs Rica, but 

□ PiuDOS 16 iuail flSta Ciypes SB3 - iHE) camnaL be ejflicjted 
under ProDOS B 

n PiuDOS ft ayuem Ellea Ct>'pc !PF] or luiraiy fflca ftyjSC 10ft 
afirot he eicculcd undei IProlXJS l6 



The ddiiill apeistiflg sysum en the Apple I[5S ftllci i cald or watm 
rcstaiO can be einticr ProDOS fi ot PioDOS 1-fi. -[ieperuUng on iJw 
ftfg!(ni?ilinni af fJes no iJit Miilup disk. Sec 'Syslwn Siamip' La 
Chiprcr ^ 

Humuns iimief PruDCM B does not doable mcmiMT beyond [he 
addresses ProDOS li can leach, hot docs li dujabl* any olhcr 

nlHriEEfi Apple ]!£>§ feaEiuEi. All si^m Fscufs sfs aiasvs 

av-jilable, €»en ibDu^h iji applioriun icadf may mike use i^r aoly 
Uw 'FfoDOS fl-slandard Apple ][" portion. 



Summary of ProDO$ 16 f^otures 

The fCjIlaiMnE liife siMnmjjiw ihc prrLndpal FeniUTW of PraEKK Ifi. 
Kefcr Id the ^oSMry and to appinprlawj cPiaplcis for dcnnitions *n*i 
iKpilaratiCsrw al Icrms Ihai rrtjy be utkrimiliar to rau- 

In fiensrot, PtoDOS Ifi... 

D is a siniigtc-tuli cper«lng system 

□ supports a hiefifcWta], tice-stnicn.ired Tile iyslcm 
= atl^ivws dtvicc-inrififKiideflc I/O for blixJt ■devices 

FtqDOS 14 lyitam coHs... 

□ use [he ;5L m.nnjCTi!>ri and a. panmaet block 
n return erfOf siarus in Ihc A and P registera 

□ preMrvt: ^D clhci CtHJ rtgisterr 

:j cm be raade frtira fi^caiS native ftMxlt oi- 5502 G-cuilHion mode 
Q can be itiAcJc frjan any^-tuitt in memoiy 

□ tan iA:^:^^ parime[Er btocfe tha[ irt anywhere m memory 
in Ckrt use poiJTtei* [tla.[ painl jjiywheie an mp-mnry 

D cam VimftT daia anirwhcce iA mcmcry 
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TTie ProDOS 16 tile rnanogBinent syEtsm,.. 

□ uses 1 [lierjfchital TJc stiuciure 
n supports 9 paihuime prcJbiei 

Li aUoRT byie-oriented attcss [o twih diiraofy [lies ind dau fUes 

□ ll].«aws iOes dynamlcalLy and noiKOntJsuimsly 015 blw* 
clpvicc* 

□ -supppits ipujc Dies 

n pcnvipJes buETcire luLprnfliJ gaily 

□ fuppoits acijcs? :iiuibiLti7s iKal ccubif /disable 

□ reading 

□ writing 

□ lenajiUnii 

□ dfE.lroyiilg 
fi feicJtilp 

D asi'igm a system IBe fcvel PJ open Bka 

U aulomatjiaUv mifks files with daJs aj^ time 

a uscsiSiZ-liyieblockalac 

□ lUuWS volume SLiCs up (O 33 megabytes 
Q allows dau rife sJjts up Co T& Tnesabyics 

□ allows lap to 14 vcJumes pn line 
n allow* up to e open fJcs 

D allows (A (JisfflOEra pec piclmame 

□ allows 64-diaiin;ter preriie.? 

n allnwTi 1 5 fliajactcrs per voturne n»mc 
O allmra 1^ {^hiracce]^ pa file name 

The ProDOS 16 device nTanooemeiv) syBtsm... 

n wppons ihc Pr^jUOi Mock dcvio; pcisJiKQ] 

D names each Hock devioe 

Q lUows 15 fhtiraQen per ilevice ivaroe 

a allows H devtaa on line sImuiiartcousiT 

n pfpvirics 1 FOFiWAT ciU. to iniUiliie disks 
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Ihe Fro'DOS ] & inlwTi^t manaaenmnl syateni. . 

D CKCivca harciware irnermpU raw handicd by Jumwaic 

D aMw3 iraiilUuan a( up [O 1& incorrupt huidkrs 

For rrwrroiy managanifnt,. Pu^^Oi 1 i, ., 

U dynajiUQally altuKslr^ incl rrJcji^ri sy^trin bufff^rs. (thcougti iJlc 

D c^n dirsalY 'KWs up lo Z^'^ bytes (Id nwflabvics) of nMriK^V 
c can mnwliharaJnimufiiofJS^KTTicmafy 

InodflHSOrt, P^0DOS^4... 
c pravides a quit caP W efeSnly cjril cfic progiam ard ittJt 
iJuHJier. wiiti iht option at rctLunia^ Ijier lo ihe quLiiina 

prugmn 
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ProDOS 16 Files 
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The hisfSi part, of ProOOS l6 is its fUe manaBcmetil sy5icni llilf; 
CtMplci eipljiew how Kles arc nwried, haw ibey arc tt«.TCd and 
uswJ. ^nd 3 Ulllc tbout ho*' itiey are orsaru^cd 0*1 disks. IE diioisscs 

For more deliLls on QJc ftHTOii Mid urjjaniEilion, see AppSi^aU A- 



Uslng f{l« 



Filenames 

Every ProDOS ifi fUe, wtiediBT Jt is a di/eaofy file J*ta Ele, or 
proa«rn niE, is idenuned by a fflepanie. A SToDOS i6 JUcnime 
an be up to 15 fhanctcn Itma. U hum b«ain wich a lelSttr. and miy 
canuln wppcrcasc letlfi.s CA-Z). llijlitts C0--5), Jnd pcriada- (.V 
[cwetcass knefs arc auiCinuticiLly toflveHcil lo uprcrose, A 
rderums inust be uniquJ? wtlhjfl JCft dlrecLEWV S>7rac cKimples (Urken 
ffom Figure 2-13 an^ 

HY.FBOCCLRH 

An entire disk ts JdcnLiffed by iis TOlumc junie, 'ihidi is tJie 
flteimme of Lii volume diicaory. In Figure 2-1, ibe disk"* volume 
name is /diskB*. 



Paitinamei 

K ProDDS I'S piLhn^jDc: a i scilea of flieruixLc^. cadi picccdcd by a 
Sliati C / ). ITiG Grsl. TilciiainB Jn a patfutaniQ is Dhe Euune al a. vnliime 
dljT-tiaiy. Siiccesslve aieiumea inidie;iw iJie paih, from the volunre 
dJT«ciory id i]ie rdc, ihai Pri:>DOS 16 musi ralSow ld Euid i parUoilAr 
file. Tlie niB^linuEii Jcfigth for s. pdihmunc is 54 chonacrs, 

/DISKS b^BI.PHOtpAN 

/DISKSE/MLHOS/CEIKPll 

All pgll j ! ihat lequlfe ^ou tfi name a (tie wfll accept elEher i ^]| 
pathname cr a |)&rtjal pathname. A paitlai pithname: is a piHtiU) 
Qfi« pathname; you ca,n wH iJui n ii riCT » Ml parhnawe becatiM Jt 
doesn't begin -with a slaili and » volume niiEtc. The nuAiruum 
length For a piitiil pathnainc is ii4 chaj-a^:lera, including &laabH:g. 

Ti^se puiiil piiknamu aic dill derived from the sample 

plthnEmcs abcvc: 

5Ai-Ea,J0W 

^rHoa/cziAFii 
tJiftpli 

TraDOS W aui>:nna,tteillv nkls 9 prefix lu ihe frunL oJ" patiral 
pathnimes la fDrm full pattinittics. A prefix is a paihnunc that 
IjidicUEs !L duEOary; It always bcjtiTLt with a jsluh and a vnlume 
name. Severj] prpfnes are siored irtemaSli' l;;' Fro&OS 16. 

I^QC the pinia.1 piLhnimes. listed abDwc tc Indicate ihc profKf IiIde, 
ilieir picfLxd should he .set ca 

r'BTSSBS/CHftaTS/ 
/DI&Kli/ 

/Pisjas/ 
/niSKSfi/aiiiOs/ 

re9<pecijvely TIk J^luhcs 3,[ Ihc end ct these, prelixeg air: apUDnal- 
howc^ci, ihcy arc mnviHiiHU rsntndcfs tfiat preTixe! Indicate 
dircEOfy files., 

Xfie maximum Icnglli for a prcfii is &4 chaiaae-r*. The mlrturtum 
Jcnglil Jbf a prgllx is zero diaractef?, tnoan m a mill pcrfii:. V"ni* 
M^ lACl lead pieTutcs using the talU SEt_tR£:Fl}I arid 
Get prefix. 
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* JVote- Beauso both a prefiit and a partdl] palhnin^ fJfi bt up 
lo 54 rtiiacicra lone„ it is- pcssBibe Tu hai'c a pathname tpfefis 
plug partia.! pailmime) whose effecttv^ \cng\h » up to IM 

ProDOS 1^ iliowH y*M m set mare than una prtHif, and thcti fefer lo 
e>ch picrw bv code mimbcra, When, i& tn the above e^mplcs. -nfi 
partidsUr pirPiK nutrijec is specitjod, ProDOS 16 adds ilic dcbob 
prcBx CO [lir^ parlJaS paihnamt you protJdc. Sec tliipicr ^ fur a. 
mote cojnptete oipJarai:^!! and examples. 

FigUJie 2-1 LUuiliil** > hypolJietical direcLory sLnoclujc- ll eoriains 
allL Lhe fifes mcnliancd abnvc. ?io(c [hll, even thuiigh i^re ate Wq 
lltes ttimEd pMETT.aBiD initfie volume direciory /'ErSK.Bt/, 
ihey are CMily disliciguL^^d because llliij' in: Ln dlfTei-ent 
stiMbTKEoiiwCMSHoa/ and charts^), TfeitU why a foil pathninw 
a flaassary to complctcLy spttdfy a EUc- 
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stiuctura 



Creeling (lie; 

A (ilf is pla-cf d nn a. disk by ihr CREATE c»A. Whei yov cr&MC a 
file, ynLt isjij^n it the following, pjopemes' 

a A paih.narrtf Thj; pathnames L; a ujiiqifc pa.th by which clic liEc 
>can he Idcniineil irnd accmsed XhiS pvhtiimc musi pJace eIk 

n An access byte, '[tie -ituc of Lhia bylc dclrrmincs wtK[hci oi 
flH live rjc uii be writlcn Lo, read frtim, diJisLrtrvGd, gi icmmed. 

□ A Sle TTpc. This- byic indlcaics in Qdui applLi^^niu [tie type of 
InTofrnjiJan la be aared in the file. ]! does noi alTeiiTi, In any wiy, 
^ ■dtnienu hsT ilw flic. 

n A stAragc *yp^- T'^'' Wf* detfyrntnes t^e physfccjl lornut of the 

fi3e 4jti iJir di»k. The re aic unJy h*.'D ditEereriL roniiia.l±: cnc Js used 
For dtprtlDiy files, the other ffM nDn-diiicclorv EilftS 

When ya\i trpiw s Tile, ttkC piopcrtiea listed ibovc an: placbd aa the 
dijilL, Jlc.ing uitti the cuj'ircn.t system dule and limc C^lt^d. crca^an 
iUlc jjid crcadfin ibne'J, in i formal a& aliown in Appeniitt .Y 
Onee a met to« been H.Teated. ii remains en the disk untE li If deleted 

Cii.sljr« itw BE3TPDI ClLD. 

To etirdi what lhe pri^pQiu^ fo( a ijiv^n fi]^ are, uae [he 
c;et_fii:e_ihfo call To alicr iia prapcides, use the 
SET_FI LE_^iMFQ caJI. To chanfic die CiLc':: nanK, us* the 
CrFCANCE, PATH caJI. 



Opening TLEds 

Before you tin. ^ad irSataaiiun Erpm or wrLie InroflllUlion ID % iSIc 
lltaC bas been ctcateii, ydU cmJSt USe the &P EW taU lo open [he fUe 
fo*" access. 'WlKtl yuu Open a file ycoj .spcdfy il hy pathxiajne The 
paihnamc you bIvc jintrt jndlcue an ejidstinB file: the ELe tmst be on 
a di^k n]i.^)i[«(] in a disk drive. 



The QPEH call fKnjftVS a tefcrttitc numbicr (rF/_nunfl and the 

iot^ijf.m of * buffer (to_tuffsfi to he used fisr i«nsferfing d^tn t& 
and ftcm the fUe. .All aibjKqtieni reletencaa ini i he t>pGrt fifc musi 
use JL% reliirawe nuitilltr Iht file lecnajjis open until you use the 
CLOSFlcalL 



Each open file's ]'0 hulfer is used by The sysi^m ih* eniitt time [he 
file is openi Thua, [0 cort^n-T infifflory iSfHcc. i[ ba wl5c ta keep "^ 
j«H files Open as pcs!iWe. ProEJOS 16 alkrws a jnarafflUim of S Open 
Files si. 1 time . 

When you apen a file, Kwro oF itifi file's chiraneriSlns nc pliced 
into a rcsian dF memoiy tilled * file caairal block Several oJ 
llrsc chafsa£ristlcs--ibe Incaiion id mectioiy v( ihe file's buJTef, a 
pointer la ihe e/id of the lilc ([he EOF>, and A jWlmcr lo ibe airicrU 
poSLlliW In [hi: file (ins file MarkJ— *f? accessible W spplicauCJivi 
vii ProEKM k*l calls, uicl tniy be diingtMl ^Wc ttie file is ripen. 

11 is ImporUnt to be iwire nf [he dilTtreriws bciwccn iJit Hie as la 
eMS\s on the didk jind when it is open, in mcmocy. Aithnujjti swik of 
llic file's charadcrislJia iful same of i» tiia maT be cri mcmnnf at 
■any given Cime, *e Me iiself MlU ftsuiea on ihe disk. Ttvli jllowa 
pnjDQS 16 lo nttnlptilitc filca !hJi are much larjjer than ihc 
compyiec'ji memoiv CipjCitV- *s an applltalion wiilCS !□ ihc Hie 
and diinge^ It! cJiai^dciiKliia. ficw data and chuatlcrisila, arc 
V/rmcn [□ liic disk. 



The EOF and Mark 




i 



To aid reailiil|4 fram anJ wnling [□ lies, ciCh Open file has cne 
p<hifltej indicating the end nf ihe Pile ([tie EOF), and snoihct 
dcfiniTiB "lis airrert ptMiLin-nn iJi [he file (iJw Mark). ProPOS 16 
Euoves both tiOP and Mark iiilH-jmaiiciLly when necessary, bgt an 
appUcalion pffiKfitn can also move Ihcm mdepenfienLiy of 
ProDQS 16. 

The EOP i!f itic mimbcr of feadaWc bytes in Uic file. SirtOS Ute firar 
byte Jji a file hM number 0, ihc tOP, wfien UMlP.d as a poirtier, 
pcHn[5 one position pa.'Jt ihc SasL diiTaeiaf in [Jir file 

TOwoi a fDc is uperteJ, thrp Mark i3 Mfl TO IncUEaie the IlisL bylc LrV [h£ 
file, il to ;nL|(mia[ii:al]y mCivecl Ei-iiward, rjne b/ic (w eacll hyu: wrillcrt. 
lo oj- lead Frani the filti The Mafk, ihen, always IndJcaLH [lie iwM 
byW tn be icad fram ih« file, or ihc neici t>tc pcfiiuort m which [o 
wiile new dsta. It cajmol exceed iIic EOF 



Ifdyjinj i wiilc apeiajJon die Moclc meetj i}w EOF. bah Oie Marli 
iind the EOF an* mcTved forwijrd ona jiuailiori /or ci^ry addiLiidnal 
by[e wjnicn TO ilie file. Th(;s, jddine byics in ihe end fjf Ehe file 
»utcimaticiily advances ihe EOF in aoeommoditt the new 
InfoimatliBL Higure 2-2 illustraies Ttie relatianship bepJrt*il the Mark 
andiheliOP. 

fa 1 Beaming posttion 




CM wiAni; ittAim: 
<JO Aflei writing tWO more bylesi 






"r I I f i I rr a 



Flgurv 2-3 

AutoiTiorle JTTCivwTwit o( EOF and Mark 

An appUcaLion can place The EOF inywhcre, Fram ihe currem Mark 
peiSJliorii 10 ihc murimiim pos^lWc b>lc poslunn. Tile Martt can he 
placed anyfti'herr from the Ijta byte in. the fite EU [hf EOF. These twa 
fijincann,i«n bcaccDmplislicdiusLna [he SET EOF and SET HftHK 
calls, 'llie ciiirenc values rjf [he V.oy md ttK itark (.■an be 
dewmiined usinjs iJic Get_eof and Oet kww ciDb. 
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Reading ond wrffTng W** 

MAD and HBiT^ raiiit to ProDOS li6 rraJisTer {^u between ineincny 
and a. dh I'dr boiTi t:ani, ttw appliaiian ffluST Specify iJiree things 

□ ITie (eEeretiffi number of ihe file Cassigned when ihc ElIc wis 
□pcncd): 

a Ths IcoHan in memory of a buKcf (aflta_buf feri' Ihal 
OoiuaiftS, or l* ra coiValn, Ihc tTirufcrred Cl •*!•). Mole thit tti^ 
cannol be iht s*rne tnaffer (5ci_burf:er> whaHC 10«[liW1 was 
reamed when ttic (Os w^a Ljfjciied 

n The .fiumber oE byics to be LnnftfciTBd- 

WhHi Lhc retiuEM ttas been arrled crul. PioDOS l6 passei back lo 
I|k appUcaciDiri the numbcT of bytes diat li actuiUy tnuufcncd. 

A icad or ftiiLc requeM siarti HE [he cuircni Mart, and carkiinuos Liniil 
clw reqtieswd number af bytes tiai btefl iraruifef fed Car, an a read. 
uit[£ [he 'End'Ornif 'hsa been rcachc-dj. ElEad requ^tiis >C3n il^a 
iermtnalic when i ipcoficd dtarttier is read. To mm on ihis feaiui"; 
and »c[ ihe thjiriaerts) f^f* which reads tcrminjle, u« rhe KEVfLlNE 
call. Tbc ncwLuic- read modic is lypitftl'v l"*^^ f^f reading ^iatS sE 
Wl« tKxl K¥ leinbLruitd. h^ -cujiajic rclums, 

* B)i Ihc way: NcilbcE a REflU rtOc a WRITE call nDccssarily jaurits 
a disk S^essi ]'>flD03 E/O buffer Eor cadk upCrt file 4s 102^ hylcs 
in size, aind can hold urw block {51J bytes) af daca.- ii ia only 
when 1 reatl or wriit crosses a bJcidi buundary thit a dlFsk acmss 



Closing and (lushing files 

Wtiert you. TinisJl readuig frran nr wriEing In a filt. yoti fniBl use ihe 
CLOSE taU Id dose the file. 'When yOu use ihis ca]l, you 5pcdfy only 
ihe referente nunibef nT the file Cassigned when the Dte was 
□pened). 

CLOSB wnk» any ufivMlnen dsa tiam the file's l/'tD bulT» ic the n>«, 
and li updates liie file's size in ihe dlTeciory, if neaissjjy. Then Jt 
frees die 1024-byu: buEEcf spatE fur other uses a nd raJeascs the Tile's 
ref«i«rtce fiuniiber ADd fUe eantrol blodi. To -acccsft ttK file ones 
again, ynu hive Ut TEOfAfi ll. 



InftHtnatlon tn slie file's dij-cctrwy, such as (he Itlc'i gtze, h DOmudty 
Updwed (nily wticn the EJlc i^i clmcft if the usee ■AWC 10 pKSS 
Conirol-Reset OyplaJly hilling iht tuircnt progr^mj whjic i Fdc is 
open, diu written to ihe file since ii was opened osifd be loit, and 
the mlrtgniy tjf Ihe disk amid be damaged TWi a,i\ be prcnrcnEed 
by usmg the FLUSH (aH 

FUrSH, lite CLOSK, writes any UEiwrllten d?la Emm ihe file's lyo 
bufttr la the fLIc. aral tipdalei the Rle^ siic in the diicclary. 
However, li keeps the fife's buBer space and iGfereuce nu^nhw 
aoivE, an.cE il|i>i»r5 torttinijcd ictess to Ihe file. In other WDtde, dw 
file suys open. If the user ptessw Contnil-R&sei while an open btit 
fliufurti ESe is in nienu^, ibeiE Is no loss of ilLta and no liismtst 10 
ihedEBlc. 

Bah the Close and flush ailts, when used with a reference 
mimbet af 0, riomiaDy cause sU open mes to fio dosed nr fltished 
SpcdJlc groups of files can be clesed or fushcd uaimg the sytteraJilB 
la^Hxx iicAl). 



m»i«v«b 

When i file ii Dptned, ii is JMlgncd a Ic^cl, iccoidinB uj the vglye 
of B spedile byte in memo»>' (die Hj^tem ni« IpveC. If ihc fjle leveJ 
i! iKvef Changed, the CLdSE and FLIJSH calte, when used widi a 
icfeicncc number tjf i>, cause ait open Tiles to Lc clcucd or flushed 
Bui i/ the tevet hu been ciiajised sintr the firal fib was opened, 
aniy ihosc fifca opened wheii Jie lilc was gieaier than of cqUill IQ Che 
cuncm syEt^m file level aic doseii or Rmtuni. 

The sysosm file lewet feaoirc may be used, far orarapic, by a 
cuntidlitig progium such is a BASIC inierpreLcr !o implcmtnt an 
EKeC canunajid. 

1. The jrttcrprrlcr opens jn EKEC piOgram file when Ibp level is. 
5D0 

2. iTie itucrprcLer ih£n set* the level u\ sa^, J07. 

3. The EXEC proBram opens wlutfiver files il needs. 

A. The EXEC prrgtam cMCuLcs a BASIC CIJ3SE eommifid, to 
close all the files II fia-i cipened Ml (ilea ai or abow leveE St)? are 
dosed, bLit die EXEC file ilscJf remain & oper, 

Vnu a^Sigrt a value to the syscein file tevel witfi a 5ET_kevei. call; 
you obtain die currenl W lue by malung a GET_t,E!l/EL all. 
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Hia format and organlzaflon 

"iTili ponJon of ihc chapter iltscrit^ In gewral terms ihe 
DipnJzacior^ of files on a cUsIl. Pac mctc decaiEed InJbrnisciQn, wd 
Appcndur A. 

[[) ^nertii, ftni^rifura rtten [r this iTi3.iTjaL Eo [he hienrc^iJdl 
relatiDiiship? smong files — dLfectories, 5uhdjiociories, and JlLes. 
/''(irmal refpis tn the arrange men! uf inrurmaliiiii (such ais headriE, 
poiiiicri iai dau) wJtWni a file- Qrsani^attan rsFi^is to ihe ffljwKf 
in wbiid] i suislc file ii Amtd (Ml disk, I n teems nF indlviduil $1 2- 
byce blocks. TtK Chicc conucpb ani Scfjuaie tHJl ttltefn^Mei For 
enampLe, becJuM or PfOPOS M's hleriirdiical Tile flrtiai*»1<l part oE 
[3ic /oimof cT I dircdtsry file indiu"tes -po-firef to the lUes wilhin 
■that dlreOQiy. Alsg, bc^Lue files aic tjrj{ilnU^du nOACOntljuom 
blocks on dsk,panof iheJtwrnifUtjf Fvcrj' file laigcr ihasuMie block 
Includes pDlntETB \o □[her bloduk 




SClimbu^ filiv Hive no siii:h pinl^rirlJed IflTjCHul fomt^t: thfl 
amqgBIIHM or |t>e ti*U dopfiidx nn [he apcdfie fik [Vpc 



Directory fl1«4 on^ $^gndard files 

Every PtoDOS 16 tile is a rtamctl, tjrdcrciJ sequence Of t'ytM ths[ 
can be read frc>m, ind to which the rules of Matk arvit EOF llppEy. 
tiOnxn;^:', {ttn^ ilt '1'b<(1 'V|P^ Of Tilf^: dArcctary fileS and SUUtdafd 
Hie*. Dijcclaty BLcs ire speciil fifci ^^;^^ dtSCTibe and poinl to 
[Mhei files oil the disk. They miy be icad Eicin, tiut ilM wriCKA CO 
C«K(«pl ]^ PrtiDOS I^]. All n[]EidIcE£lojy JUcs aic standlid iilea 
Tllcy may be icad EtMn Jrid wrtuen to. 

A dlmjuy Qb tanlshia i nLuubci: qF ^nukl- dements, ■a.ttvl 
entries Tlie firsl emtv in a gUreamv file is ihc heat^ cniiy: it holds 
ihe [Mine and other prtjpenlftS (such as th& ciymbtu of files stored In 
(Jul dlicaofi,'; of the duecmrv file. Eich subseqijcuL cri[r¥ In ihp fDe 
destiibas and pcinis lo btmte odier file or iJie di.-slt Figure Z-3 sho-wa 
ihc fatmaL qF a tUfcnory flic. 

Hu^ fiCea Ik^jCrilK:(l incl ptiiri[ed lo by ^e eruftes In a dlrcoory fllo 
can be standard files or other dlirctdry flird. 

An applicitfon rfccs nO[ nfcd [Ci kilrJW [he deuili of dlfeonry 
Jarmat to access files with krmwn names Only Operaiioni 0(1 
uflkrtown Tiies (sud'i is WHilng the files in a dlcecto^!) rcquuc the 
j.ppLic:aliaii la cxLuiunc i diredmy's entiles. For such [iiJij, reter ti> 
AppeiHlix A. 



: \ 



nrMMtvnta 


Rncrory Fllai 


HeOiblfnh'V 


__-- 


FIpA 




(FIB A) 












F»eB 




FIB E"-<rT 








■ 
VcnEnlTvi 




MfTWt 




FJgEmrv 


RbW 








FIgUr* 2-) 

ilrecrory file 1 







File ofgaf^lzQtJon 

Because diiectary fUci arc ficmSrTllly smillef thin standard files, 
jn(l beeiuw tttey arc sequentially accessed., PrdOOS Ifl UMJ a. 
alTTipler form uf ^[ijira,^ for dJicctcr^ Itlcs than ii does for i iiindard 
files. Both lypes at files artf aturftl ju a set OT 512-bytc tritxiks. but the 

way in which [h? b(c>cfcs are arranged -en The dldh dUTers., 

A tiiicatiiy file is a Itaked Il»i: cJ block!; «acii Wnck in i dircdOry lile 
tontalna. a pointer to the riert block m ihe dir&raty fQe la well as a 
poifitei W> the previous Wock in Uic diccclury. Figure 2-4 illiiiiraies 
this OEgajiizaU'cirt. 
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tokx ■"? 




^►r.r..^ 














FIguw 3-4 

SIdcIK Dfganliatton of □ dr^Ctory nl» 

DaU Ucs, on the ijlhcr tl^i^d, 11% Often qULDe Ijifge, ui4 cliclf 
cfHiKAts (Hiiv be rafidnmlv iccrascd ]i 'wnuld be very siovj lq i«:e&f 
such lar^ files IF ihcy wCr^ urljartLWd senoentially. Inilead, ProOOS 
16 Stares standard ii]cs using a Wti Qf jphlteDclnn 1tifr 1ar!i;c:;[ 
possible MiildarJ fitc hiA i master Index: bbtck IhaL painCs lu 1 21i 
icidci blodu Izafh iEtd» bbi;k i^oinis ro 2^ data hlodui and cidi 
data hktck can hold 512 bjjtf!!. of diEa. The block cirgam/jlion l>r Che 
largesL postlbte sundiw) File is showji in Fij![urp 2-S- 




RgLirs 7-5. 

Sl&ck ofgortzaHon of a s-landaftl 1Ba 

MiMI sundiiJ rOiis do na have thii citSCt Orgafiiallnm. ProEJOS ifl 
□nly swrilcs i subset oTlhia Form tc [he flie, depending nn [he 
amouru tifdalJi wrinen. TTiis tcdiniLpjc prodtujci. three diiitL™:! 
ffwins of scaniiard fitc: seedJing, sapling, and tree liJcs. A3I thtee i« 
e«|]i4ilneiJ in Apftendu A. 
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Irnporlunl 



Sparse flle» 

]n (iKTs-t Lnitanccs a prosrjw writes data stquefiLinllv iniD a Se. t)Ul 
by wfiUos daii, moving Lhc EOP and Mirlt, arid Ehcr writitig more 
da.u, a propam e?" ako wuitc nunseiiueniJal data in a. file. For 
eicuiiple, a program can n^pen a. QJc-, write ii few charadcn Of illi., 
3Jiid [ben ninw iIie EOF a^ Mark (ilitacbv mikjng ih* flic bigger) 
fiy an aibiuaiy amounl Tjcfncc wiiUiig i. few mnrc hj-tcs of dau. 
Only thOEC blocks ihal ctjutiLci nomciD inTurmation arc actually 
illoeicecl for ihe file, so ][ may uke i^p h few as ttiree blocits on Oic 
dL-df Cai iniaJi uf 15^ biTOs^'- Howcvei, aa manv byics :u irt ipeciricd 
by |he valiip of EOF (up li> l^ mefiativus} cari poieniJall;^ be ccid 
from iL Such Rlcs arc Itnawn as Iparse Blw. Sparse fJtS Ife 
fnpliaard ir mnic dels I] La. A.p[MJidi34 A. 

In 1ti:HBr»fr1ng sporae nias. it« tact rhoT *T>ore aata can b» rwisd 
frgrn Ihe nie Hion actJOFly r^^slde? on the diSK can cauEG a 
p*obwm. Suppose Ihal vxi were ttvlng ic ccisy a spcns^ Tiie 
(ram cnB- ctok Id onolhw, If v^u ■ware Iq read Oa^n ■ff^rn one we 
and wilt* H to anottier. Ihe new 1* would ba much \atgen than 
the [yiglna! b«oaL»« Ooto then n not r>sruaiiy en rua disk can 
b* r«jd from ttie PIb'. TlniiB if your -appKotlDn 1e going t« hatuter 
W<jrw nies. Vi^W muBl use itia lnfC«>T>oWcn In Appandlx A 'a 
derBrmlne which blKri^ StlOUlcJ be coplad, and Which Bhould 
not, 



Tb* Rle utility proflranu supplied wilS [tw Apple llGS lULomallcally 
jHGscive Ihe sUuCWfe nir^pirac Hies an a copy. 



30 



Part !■ h£ow PfnDOS 16 Worio 




Chapter 3 



ProDOS 16 and Apple IIgs 
Memofy 



„ 



* 



ai 



im 



Stricdy ^pedung, nxmarf m3.at^f>K«i b ^gparjic fcom the 
openiinj^ system in itic Apple l[^b. Thli diapier ^IictU''-!:! Iktw- 
PkjDCS 16 l«e* msmcry and how ll IntejaOi wilh ihe MemOJV 

M&IlBgCI. 



Apple IIGS memory configurations 

The Apple IJGS miceoproesiSOf •!' capihtc of directly addrcsairtg: !fi 

COIlHBHraTltMi for Apple llGS Is 256 kiloby-lcs flWK) <J( RAM ind 
IZHK of HOiV, anan^ed wlihin the l^lb metiwry space M »hawfl in 
fintfce 5-1. 




The TOial mcmnry spjcp te dlirided Ijuo 2S6 l»nkl of &fK bylos dcli 
Cscc- Tabic 3-13. flanki SCW ami Ml are used for ^.^tcin sofpjare, 
ProDOS 1<5 ipplieaiitms. snd arc Ihe nnly rn(M110l>' Space utcupicd; 
by itatldartl-AppIp II pfD.gfiim Mnni^ig unJcj- PruDOS B. B^nk^ 
JEO and JEl ire lised priildpilLy fur liigh-jc^rJlmJon vldtso display, 
addltloilJ] System s-aflwarc, and TUUkt-lMSed IudIs. Spcdallzcd 
ireaa dC KAiM in ihe-se tflnks Ijidudc ]/0 spaoe, banfc jwJidKd 
momcifi,-, anil display buflcr^ In InrAtions consistent with standard 
AppJc n nicnii^ OjiifiguralJors Csoe "Special Meiwory atid 
ShadnwJng," beti^w), llan^ JFP andSPf-; srt hOM; ihcy contain 
(irmware and BOM-hasftrt rooJs J-"t>r morr dctaDcd plciyres of 
Apple lies LVlfimory, see Techrtaal Inlrcdu^ltrm in the 4ppl^ HGS, 
Ajiple lAlS fiarUaare Rsfirsnce and Apple IISS i^irmwarp 
Hefirmce. 



Tahta3-I 




Appt« lie:: mBmDTv iJnlh 




Unir 


lb 


n IbbEt 


< bits CotK-haU" bytt> 


byie 


SbliB 


wofcJ 


SbytES 


lOnjj WGrd 


4 bytes 


pafie 


256 t;yies 


blfXk 


5 12 bi.tcs {For disk Moragci 


bi.[iik 


jS.5.!li byres QSfi pages) 



■Wilha l-ritegibylcApplcIlGS Mt^mory EjcpansLon Card, ]iS 
addiil.jjial banks of nreniory are manJc arailablc, they are 
numbered st;[fueri|lslJv. froju S02 10 Sll. ^^I|>i^si□^, banis have 
none of iJic spcdaiiicd mcmofy Jrtas shtjwn fcr barks J0t)4K>l and 
JEiQ-SI-':]— all 6tK bjJtes in ead^ bank aie available for ipplicaiiocM. 



Ctwipur d; PioPOS lb H3nd Appla |I?s MetnofV 
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SpKloi mamory and shadowing 

Pot juimiii^ 3«n4uT) Apple II softwair. nhe Appk riGS mcmorK 
cmnBUratltm is M! jo thai banks iOO luid SO) fte [dcn[i«] W the 
Main and Ausiiiiy RAM "f^ ROM H5fi an Apple Ik «r an Appk lie 
twlcli Musn Jed UJ-calLimn cifd. 5m .Afpfc //c TscHtxIimI Sefirsace 
Msnupi ai Mppie /fr Tacfswit-fiif Heferenct Manual (ai details. 
Because ihe*' are used b^ iun-dard Apple 11 ptognwE. bolh bmks 
MO arid J03 , is well js Lhc display pflfjcB in banks SEG and SEil , »rc 
lulled fijtedal mcnmrVi [tiere are lesiriCLions on ihc plafemEtit of 
Dtnaifl Cl'pts or ctjJc I n speciii memory. Pot cianipk, any sysTein 
softwur iJiis muat jcmiin iiJllvc in thr iusidwd Apple 11 
EOnfievfition. canna be pul In speaiL memory. See "Mcinnnr 
Manigcr" iP ApplF HG5 T&oMiffle figtmitff Tor raoic dc[ail5 

StiMtawljig is lhc LcrfiT uwr* Lo draaribe a fwoccss wtereby s-ny 
chaiBca made lo one pan of ihc Apple riGS mematy are 
luionaiiciJIv and sifTuHa-ncousLy rrtiiJe in anolhef part- Shadowing 
is rweesssary tjcausc »ii[VJard Apple n progfattts on Oirecily 
access banks SOO and SOI only, but ill Lhc fuiBl Iwa'dons i.a.(i rfita 
itfucmrea needed by thtise ptogrami are maintained In hanks SRJ 
and SE] (see Apple n<3S tfardvmfe Re/eyencft}. when ihe prope? 
shadowing La an, an appllaiion m*y, f™ example, updats a ■display 
locaUtm in bank SOO; ihat JjifDnnationi U automaiicilly stiaduwed tr> 
bank SeO, fmm where the video diiplay is actoaltf cnntroUed. 



ProDOS 1* and System Lodder mamofv mop 

ProJWS lli and ihe Systeni Lcid cr Eo geihef occupy cjcafly alS 
iddcc^es ffnm SDOQO chfMgti SETTF In bO[ti banks SOO and SOI 
Thi5 IS. lhc same mejnory space thn I'toDOS B wxi^pics in a 
Standard Apple [1: all or the language cafd area (addi'esBcs abuve 
S&OOO), indudjiTB mwl n^rtarJi-swiltticJ rrtemory. 

In addiUon. PioDOS 16 rescmss ClhiDugh lhc Memory Managed 
apprnxJinately 10.7R byiEB |u5t beltJW JfBOO in birtk 5(10 On lhc 
rc^iOrt normally ocoipied by BASlCEirfl'tiM in a sUndwd Apple 
HJ, fnr I/O buITecs, PedDOS S inicrface tablca, aCKl oUicrirDde, 

tTie pan of PraDOa nfi iJiar cnnirols loadrm nf boih PioDO^ iS and 
PitiDOS S pldgfants is Incaled in fians ol' bjrtk-iwitcticd incmo^' in 
binla JEO and JEI. Other sj-stcm Hirwafc necupies mwi oF the rear 
d! Lhc tin£Lt)£E eud :.rras i^Fbanks SEO and £S1 . 
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Part E: Hew PioDOS 16 Works 



N&nc of ihc?e reserved mcmprv areaa is availaWe for use by 
applications. 



■ ticr-i ^ijTHie'l 




tS('itarTi LoQflBi 



SHnarPioDCaioli 



nguTB 3-2 

ProC OS 1 fr and syjtefn LoaOar iTbanrrary map 



Gntiy poM* and fixed IqcoNode 

Because mitei Apple 1I5S memoty Uocka are movable and under 
the cunlral fir [he Memofy Manager fsec (Kki sctiinnj. tbe« irt 
vcT^' few liMd cntiv pt.-inu. flvailaMe to ipplicatioris prDgianuneri. 
HefefeTitei Ja Futgd isniry poiniii in ram are .wfojigly discoviirsBed, 
since ibcy arc Incunsislcnl wa[h flcublc nwmory manas^^menL and 
wc smr to ciwre corapititillijiy prahtenv? in future VTirsinns of the 
Apple lies. Inftirmatlnflal sy^icm cs|J» and icfcretLcii^ by handles 
Csec "Pomiere and fiandle-s' in th^ thaptcc) should lake [he place 
t»r acL~«»s lo fl*eil enHry poiras, 

The single supponed System Laadcj entry point fe JE I 0000. Thai 
iQcalion LsuhcentrTpDinlforall Apple HGS lool calls. 

trie sinfiJc supported ProDOS 16 cnuy poim ia JEI OOAfi. Tftal 
location w ihe cntn- prtdnt fur all PinIX>S 16 alia. Iti addition, 
PraDOS iS^pponsa fewcilicrfij(eil locations ifliiS binfc5i;i' 
vestoc apace. Tsible 3-2 Hits ihem. 



CTiQplBf 3: ProtKM ]£ and Appro iKs r^m&ry 



35 



Pf0OO3 li fteed locailons 



I 



Adfitsu lang* 

SEl OOAB - JKI QOAB 

lEt DOHA -SEl OOtSB 



cap una Bon 



Eniry vpdfw fof lU PraDOS 16 
syaeni «ll4 

Two nuU Ijytes [h"""*!^'^ '° '^ 

oa_KiJffl byw — indkaie* the 
currently running operating system- 

sw " pro[>os a 

SOS -PrtiOOSie 

OS BcraT bfie — indicaies iJw 
operitinB si-sWm Ehac wis inkijitly 
honied.; 

SQO - PraLtOS & 

(01 - PraDOS ! S 

Flaft word Tlit blrs are dcfiiud as 

bit 15 (PfoDOS busy nag}: 

- PtqIXJS is is nat trusy 

1 - PruDOS l6 is biiay 

aiBH-(t 

Tlie PkiDOS busy flag 1* cBplainctl undec 'Mik'nR OpcraUng 
Syslcm. CillJ Du finsi Tjilcrrupra," in ChaptEi 7. 

* ^Wt: JTwDOS 16 does nrtMjpport the PtoDOS S gUiba] page or 
any achcr fiaed locitions uae^l by PjflDOS ft. 



sei QOBD 



iEl OOBE-SEIOOBF 



Memory management 

PmllQS Ifi LueJf does no memury ctun&^Enertl. AD allccairon anil 
dcaltraralion liF tnemnry in the Apple lies is pciforrtied by the 
Mcmniy Manager llift Mcnmry Manngier » an Apple ItCS loal 
jcC, k>j 4 cnmplctr tlcscripliiin nf i\L funniiml, sec -Af*^ W*^ 
Tbt^box /iejeferaz. 



Th« Memory Moncifler 

The Memory Majngci is a HOM-reSKfcnt. Apple lies tcraL set thai 
fndrnts Uue aJloaLon. tleallocarian, and fieptwilionrng of 
memofy blocks in tite Appir lies. Ii works doscEy wilJi FroDOS 16 
and The Syslcm Ij^ider la pftividc [be needed memory spic^ Tor 
Eoiding programs mcf sJaa and I'or pjotJilirlg buEfcra for 
inpuVoulpuL AJ] Apple llGS srfnirtfe, indudinfj ihe ^jyslcin Loader 
Irtd ProDOS 1.6, niUEl ahtaitt iiccrtfcd mcmrwj' .space by malritkg 
icquesU (calk} lo the Memury M3ni^(. 

ITie MciiiDra ManagCT keeps Cfjck of huw cnuch ntemory is free ajid 
wJiii pans aie a:icjtatecl Co whom. Memory a illatatGd in bbxJu nf 
arbiuary length; each bldCk passcsws Msvcrail aiiribiiiia. cImi 
de*nibe hmv the M«Enoiv Manajjei mar mcJdi/y il {Such S5 mijulng 
U Or deleting .i), and Ivow it niuiL be- lUgned in memory tl« 
csa.mj>Je, nn a pase !x>«fldaiyj. TabUi 3.3 liiti th; Memory 
Mim^ger atuibutei ihaL a mcinocy block tuj. 



MamOfy hl&ck Qlldbulei 



Artribud 



E^plonDtten 



Qicd f yes; no) 

fixed address Cyej/fio) 

Tnpd bank fyes./no) 

banJi-boii ridaiy Ijmjted (ycs^no) 

S[srjaJ memoiy nnt usable fyea/fio) 



page-aligned Cyea/no) 
purge level ([> [0 3) 



Mu.sr !hc bloct renutn a: ifae teuns locaOcm In 

mem.DfyJ 

Mmb Jx "be ai a spedJlc addiTsa? 

Muai II be Jn s particular memory bant 

II ts prohilJilcd Irom Ui^iending ac/os; a bank 
boundary? 

b it prohibiEcd from fesiding Jn special memruy 
flMnks SOO, ifll. and part; or banks i'EQ, SH]J' 

Mud it be Allsncd 10 a page bovndaiy? 

Can it be puiBcrP if -■'O, Wllh what priori[y? 

ts ihc bloc* loclied (lemponlnly futed and 

unpurg.ealjkjl' 

Each btodf li also dr.n.n«i by li'i Ltacr m, a rode numher- ihai 
slKmi. wJur pnngram ouffti iL 
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Sesi«l«$ jTMtmg itui (tefeiing memnry blocks, die Memciy 
^taniger mtwcs biocks when ncccsiary [0 ccnsalicbie free 
mcmaty. When « compatis memciiT in dlis w»y, il of ^^3^JWe can 
[n9i.'« aa\y those bloci<4 thaL nceiJfi'l be taeii -'m locaUan. TtrewEoK 
as miny memoEy Uocks « possjiilt shciuLd be movable (not fiic*. 
1/ ibc Memnrv Miiiisc I* '■<> **^ cffidcnT in compaciion, 

WTien a mcmosv blocSf is nn luiigef nccdctl. the (neJ33Dry MaiugcE 
cithi?r pufv J' tdcl«K* IW conLcnlS but maintains Us e«latEncc> Of 
dlajHWes il CtompldirLy rtMliOvc? II Inim memorif). 



PoinTen cina nunuioa 

To acces-s an cnny pdint In a. movable Nack, an applicsikwi cisinoi 
lisc a 5i.mpl& pntntct, since iJw Memon,- Manaifisr nuy move ihe 
Blodt ind diarge ihe cnuy ptiini'i jddfCM- irsieid, cads limt iha 
Memoiry Manaeer aSlotiies a racrmiT block, il raluins [0 ihft 
requesting apptliSitian a buidle feferenang thai bkick- 

A hsniiie is a pninoer to ^ jsnimtci; il is the ^ijdiras of i Rited 
CrDnmOvj»l>le> iDcatlon, calfed the maBIti- polnlcr. Bhal contains 
ihc iiddcc&s of tt« Wcick. 1^ ihc Memi.iry Managtf chinges Ihc 
loaiion irf [lid blocfc. il ap4aats ihc addrew )n tht maiMcr pciinict; 
tkw value nf llie hindlc itself Jl aal ahta^d. ThiiS ihc ippUcaliun 
can condnifce to a«r!a the Modi ustn£ t!lie harKUc, no naner Tmw 
oflcn. [j^ blocli Is mowed in memory. Fiaurc 3-3 lllustralca liic 
(UiTctEni:^ btftaueen ■ polnlcr artd a. hancQc. 

If 3 block -wi II always be tixsd In memtiEy Oodted qi vmrnirrtblc-'), it 
i;ill be tefcrcnccrt by a pOimei Instead ui'by lis bandk. Ty uhi^m 3 
painter to a jMrtlrular block Or Iticaticjn, an applitaiion car 
dcrcfCMflce ihe bIraJt's handle. The appliadlMl leai-i the 
addjtss slored in the locailfrfi potiitcd lo by llw hindLc— ihii 
iddiSM. Lt the pjinlcr lO ihe block Of eotiftW, if ihe blov:li: is ttvEr 
movEtl tliat pdnlei i^ no iDngej" valid. 

PmDOS I'd ind the System iJHidcj- use boch polnitra antl handler W 
refcjmcc rnemoiy Jocatantis. Pwhiers and haaldles rPJ5> be a1 leasi 
[tifoe bytes InriB id at-cess itic FuU iinge of Apple IIGS mcmorc- 
Hawifvet, ar pQimcra and barHllcs used as psr»mctcra by PlwDOS 
tiS air ftMir byies lOEie. fai ease of roinlpulation in ll» l&tJl 
rs^LEfs of 11*? 65ca]iJ mlcfoprncessoi. 
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Pclntdn and hcndlaa 



HHIJUIir nKV 

I I Wiy-'i- -Li-'r 



EUT^ni Ira'^<^e A[»»n nr 



How 00 opplicGllon obloinj memory 

NonTia] ilnerrtorif aJlacition and Jejllocatjmi is ^otnplelctr 
aulQmatie, as far as JppliClIioni arc mticctncd. Wlien: an 
applicatiort rtakes a PmtXSS 15 call ihai requir«¥ aUucaiinn of 
memory (such as cpcnlna j Jlle or wiling finin a lilc lo a memory 
IneationJ, Pr<>I10S 16 firal obtaJiis any needed, mgJTiojy blocks from 
the Memcjcy Manager anil then perromis lis lasOu. LtkewiEE. Ihc 
Syaiem Loadci jct^uestg any rvMded memory either dlreoly nr 
Indirectly (through ProDOS 16 ciLlsJ ffC5m the Memory Manager. 
CfmnsfjeLy, wKen an applicaiiijri ItlForms [he opcraima system Ihai 
il no luEigpr needs tnemory, ihal Jnfarnulion Is passed on [0 ihe 
NtcmoiT' M^'^nager which in mm frce^ dui a^licaiian's allocated 
nienaory. 
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My rtJi« memory ihii m appJleaii™ needs far Ivi cwn purpffi*. 
must be i*q«esicd JJ"'|=^* Tr™ Lte Mcm^^TT M^^^g^r Ttie shidcid 
a^M J» Fig^R ^3 sb.:™.' whidi farts yf .hi. Appl^ HGS mcnwiT cm 
be aUoulcd [hnJ«Jfh req-csts Ln 1^ Memnn' MaruEcr. 
AcplloEinrt? rnr Apple tSCS shoulil awoid reqiaesliiig »bsoluie 
(fe«t.sddt^) Mocks, Ch^pw^s 6 arJ 1(5 Df qllis tTLmuJ] d^n&3 
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Chapter 4 

ProDOS 16 and External 
Devices 



[nformauon Ld or (rom Lhc Apple UgS. Ulsk diivcs, ptintcis. ml«:, 
and jc7i[»ck5 irc PKltcfUl ifcvicc*. Ttic hcvboftni and sO«eJi Dxc also 
conaWcfEd =-sieinil [fcvi<!ts. An inpwl tlcvkc [HfuTcrs mftimutian 
10 ihe «i>mpulEi, afi Di^tTOi device trarusfer* Infomiation fifm [lvi 
mcqMjier, and an it^mi/ouap"' device tratisfers LnfDmiaUijn boih 
wiyS 

l"hjs dupier (Ll'^aissca Tiow PwiDOS 16 pmvidea an InicifaM 
bclweejl applicalloflS md ccrli!f! cxlcmal (tevlcffi. 




Block devices 

A 75111* device reids and WTlfca infamsiltlan in cnuldples ot OCie 

bitx'li cJ" ctiinaeri <512 b^^s^ s*e Tabic 3-]) ai a lune 
Furthers* CI re, Ll is i rpTtdam -access deiqcc— si «Ji access ?n.v block 
«! demand, wi^tjut havuig KJ scan iJurmi^ll the pitcetUnn at 
jucraediflg hloclcB. Blwli devices ate usuiUy used for siuage ind 
retrieval OhT irtrnrmaUon. and arc asualty ifipuVmilfHil dcvicES, Diik 
drives aic bloek HJeviees. 

PkiDOS la supptms awsss iQ Mock devices Thit Is, ynu mat' read, 

from ar ■wriie W a blmJK (tenoe by making PicDOS ] & calls. In 
addition Cd BEAD, WRITE, and ihc oihci Hie oil? tLaawLted in 
ChlfKer Z, ProtXH. 1^ IlLsn prmicfes Tve ■Lowcr-levEl" dr:v\<£- 
acccss calls. ThEic calls atlow yau lo acteas Lnlbimailon on s blrtd! 
(fcvlcp willtoul (xmsldtring whit fllw the Liarnrmation J5 In. Tbc. (ill* 

TTPums ihe devtcs number asitsdaicd wlili ii 
parfieuUf natncd device ™ online vatume 

fcturru itie dfiwicc number of Bhc L«i: device 
acc&iscd thiuueii PmDOS l6 

icarfs one Wock filZ byles) of daca From a 
SipeCiEicd device 

wcjlra Qite blccV: 612 byies) of dau lO a 
specirpsd devLfe 

rarmala CinitiiU'BS) a voliicnc in a. dewioc 



II 



A blDcfe device ,pMiftraiiy requJEcs K dcvJge drtvcT 10 inui'ilaEe 

PfoDOS l6"s ii^Jcfli block device rncdtfl into iLhe uacki and 
sedora Viy w birfi inJormaki^n Es aciuilly slatv^ en ihc pAjslcof 
device Tlic device driver may be djcultfy wiihJn ihc disk drive 
iiscLf ainlCiiisk™ 3.5). ii may lie indudedl as pan of ProtJO? 16 
CDilk 1I®>, rjt it taay be on a separalc atd m an eiqanslo*! Jtrt. 
This maxnja] doas nac discuss sjeidcc dnvcrs. 

♦ iViXe on fclM ritriS: RAM dlita ajt [rUemal software CDnstnicl^ 
thai [hw operatins sysiem Lfeais like enemaJ devices. AJfliffljgh 
PraDOS ]& (rtoviclcs nn particular smppoit for HAM disks, any 
RAM di^k [hat behav« IJke a bt-odL dgvloe In all rospcos WlO be 
nipparu^d iua as if ii ^^rc an onennJ device 



Character ddvjces 

A cbaraoer device rrads or a-nre! a scnram of diacaOees In ondtr, 
one at a limc h la a Sequential .kccb devicG— It caiinDt acc£sg 
anjJ posHIOr in a stream -wiihoul fim ai:(e«{i>ing all previous 
ptMOioru. ]i an neither skip ahead HOT go back la a pfevlous 
character Chjiatier devices are usually used lo pass IrfofmaTlrai to 
and fiT'iti i user at anofllcr computEr, ,sonw are inpjt ie-vict^, 
S«n3c arc outpttE devices, and some an; LRput/ouIpLil dcvioss Tbe 
la^yhoinJ. strccn, primer and commufliifaiiDns pan sj^ chiiacEcr 
deviee*. 

Current verelOTi Cil PmjJXJS tti do ™n SUppon chaiacter devlCtS; 
thii ii, yiMj cannot ictcsss diaiacKif dfiviccs through Pf&POS 16 ' 
■rails. CcnsulL the apprapnate Rnirwarc or tools dutumcntadign, 
Svih as jlppif /iKJ firmii-iarE d^ermce at Apple HCS Taalbcm 
R'ifBtsTa:e, for iii,5tracuQtiis on how [□ malifl calls lo Ihc panieular 
device yoi wish W} tee. 



Accessing devices 



Under PiqEk'jS i6, you on skccm block dc^■i[«« ihrough thed* 
(icvlcc nuttibers, device nieii£$, or dM; volurcie names of the 
volume? mnurried {jn ihem. 
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Naniftd devlc«t 

PfLiDCH 16 permil! Wus^k OeryJccs lo biaue assigned pwcnei- ThJs 
sbJl^ is a eonverviencc for Ltsers, because they wiU no Lcmei^f Suvc 
LD liiww the vofume namp in actess 1 ddsk. 
However, ProDOS ifi's support f™ aiined devices ls Umllcd. 
Dwlce tumefi miV Iw ^^^cd only In Ihc VOLUME, GET_l>EV_NUH, 
irvd rCEiilXT oJls. Oltier cjJli Ihal artSW devices require ciLbci ii 
voiumc nirae or the dcvitt numl>ir iriumed by the (^sT_DEV_iTua 

at GE.T_LAST_DEV «!!■ 

□cwii:c5 lie rtaiUMl accorlinB W » t^Lll-itl convcnbar-, MSlJtKd 
names may na be di^nscd The nintlng mnrftniJan Js is follows- 



Any btudl devlrr 
Tchere 



Name 

Dm 

H- a l-dfgiL ur i-dlg'l dcdma] [iumJjci 
tiBsigncd (swsecutiveff'j 



Lofl dHvEcfl occaued 

An apfJiailan may a.'Oc PraDOS 16 for thcIdenUtyofikielasiblfidi 
tfcvice a(f-e55«L The iaii tiaAce accessed is defined here w ihc 
dEvior to whJch [he mci5t rcircm CdQ idvoSkiriE a disk read or wriw 
<JnclLjdijia i block lejd f^r write) waS directed. 

WTicn irt application makes [he M3T_lJiSf_DSV dU, ProliXiH 16 
returns ihc iJciHm number of ih* lisi Mack devJW jEcesscd. Tt>e 
IpplfBllll^ can then use dial Lnfoimatotl Sl3 Lnpul !□ subsequcnE 

device islb. 



Block read ard block wilfe 

IToDCti 36 prijvidftsiwnilcvjctf-acii'-'a calls analogfus to Ihe file- 
access calls read arrfl HBITE. These c-dUs, si£Aa_aLDCK and 
WRrtE^tOCK, allow you Vi Inaifer informalioii I" antl from 4 
vcJuiKc on a blodt divine irEanlfcss nTwtiil files (tie volume 
corwain-f, 



ai 



Pan \ howProDOS \(> Works 



TTk ctEVlCt number of a device (remtiKiJ by aET_DE\r_HqiO (3 3 

ret)uJtcd inpul for Uie tkx* leid and write ci]|s TTie blodi read and 
wiile- alb ue powerful, but aic nor i^a fW by ^i^ist 
applicitiofls — ihc Jiling calb dsLicrlbed IJI Chaplcj 2 kc suflideri 
for normal disk t'Q. 



Formatting a dlik 

Y-uji apj:ilic;3|jr?n can fonrnt (inllialixc) a d»k in a dcvlct through 
die ProDOS ]5 FOHMJVT ctll. The call irquira both a deflM rUnie 
atid a volume name ai input. Ihc disk in [he speaRed ilcvinc is. 
fcrmiLlcd and (jii'sn llw speafied vtilume naine. 

ITiE.nJier required inpLil to the F03WWT i:all is. the Ilk sySKm ]D- ll 
^hp^dPieis Lhe tlaifi nf rtpe.tJCing nyslcm fnr which [he fUsl; w is be 
formatted CmjcH a tJOS, ProDOS, en l^ajtil). Under curicul 
vcciinn,^* ijf ProDOS ]ii. ho^ffeva, [he roEiWAT all cm formK dJsk» 
foi the PraDOS/^OS file systtm oinly (Jtle EKStem ID - 1). 



Number of ortlihe devices 

PraDOS 16 supports up la 14 active devices at a iiimc. The Apple 
DCS normally accepts jp lo 1 devices conncctKl to Irs disk pan 
(SmariporO and two devlitcs per erpa-nsion. slO[ (siiJls 1 ihrouBh 7). 
It a possible, however, (0 have up id 1 devkes on U Smartpoit ciud. 
irt> slot 5- ^'■JverLhe[e», the uxa] number of drvices on )>[« jtlD 
titiuoi cKteed ]i. 



Davico i«arch at startup 

When ProDOS 16 btwis, It performs a device seudi to Identify all 
built-iri pseijdo-s[[Jt ROMs flmerfla] ROMsJ and al! real pIlKilaJ 
sloi h'GMs (card ROMs) Evoy block clevi« [onnd is Jncarpmcaled 
uuo PnjDOS l&s list d/ deviH:e?, afld a.!i!iBncd i devl« dumber 
Cd'eu_BHiwl and tievlce name C^tw.nam^. 
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* ^tl(fl,■ CanlTo] Pinel MuJngs dtlrrra-in? whether intecnal HOW 
□r (ifd BOM IS ariiTe frtf each slui. ProDOS l6 raoAot 
sJiBulianeuualv siipiBn both Lmemsl and ciiemil devices Tyiih 
[he *ii(n* ^at nunaber, 

in nencial, ihir dcvk* search pfneceds rmra. hJgtKal-numJKred 
sLcjU ■ikwiiwaii For caample, ? ilsk drive In alffl T drire 1 wl!l 
be (Iciiice number J: sncithcr drive in slot 7 drive Z wiU l^cn be 
device 2, )n4 <)n dcwnwaid ihrcntRh all tbe sli^^ 

SmwtPDn IsLol ^'.S irteTmt ROM and diikport] is a special ClSt Up 
Id 4 rfcvice* BHY be catiM(.te4 to SmantPart. Koweifer, because 
PraDDS l6 MippOtK only 2 di=viM» pe> sloe, (he third iirtrf faurifi 
tSevices are ireitcd an if iJiey wciq in slot 2. Despst*? the raa-pfiiftg dI 
devices 3 Brtd 1 intD ^at 2, hHnffiwsr. all devices cOflpWcd lu 
•SmaftPort arc giVfift oonscculivc nujJlbftTS- Tiblc 4-1 sh<«wrt iho 
relationships. 



Tt^6 4-l| 

SmortPDrl rtumtwr, itot rwntia«. artd ct«vlf^a number 

ClMlgnmentB. 



smarten nv,^ 



■iDl Old dr>v« 



davlc* numb 11 




tioi 5 drtve t 
slot 5 diivc 2 



K 

B+l 

H*3 



"f inanPori dEvlcE numlMi 1 i» t-otinHiiptl dliECily to SsnartPort. 
Subfcqupnt drviiip^ iiu <?i5f>eCT«i In d^uy chaiii TashKn bo ihe pnceding 
onu, fo itiat device numtal -1 li ttw ftrthesi. f'CKti SimnKin- 

Apple Duik 31 jnd other rclawd 5,Z5-i(ich disk diivei are jnoihcr 
spfMiial caw. HecauJ*: ol" the rclaUvely lonji ''"^e rcr^ irtd M access i 
DIMi U drive and to determine wheihcr a disk a pjesent in [l, DLik ll 
drvc9 art gii«ft die hJ{[hc-£l device nuJiibeni on the sjsBfii. That way 
(hey wiU he seardied Idsi In any scan uf unline devltcs. 



Volume control btocks 

Pac cacti device wilh [vrauemnvihlc mgdilt fm^ 3S a hird disk) 
found ^' booi lJnt«. ;i votum« control blUck (VCSH Is cicaced iji 
memury. t^e VCQ keep: tracJc of ihc characijcri^u fif tiai online 
volijinc. For othcf devices Csuch lu Floppy dish dhsiei] feund ai bfitsi 
iJAtf . VCB'a ai« oraled as File^ a;e opened an ihn volumes Ln those 
dcvicts. A miKimum nf elghi VCB's mty Mist ai any nnc Umc, If 
you Ify to open, a file on a device whose volLirnc prcsetiUf has no 
Open files, and if there are jJready eiRht VCB CflTiej, CrfOr 555 
t^tB tJbte fuiP is letiinTcd. Thus, even though ihciz: may Ije vp to 
14 devices con n gdc d tg k<?ut system, o^l^f eight (al mcsi) can be 
aethrc Chiive opCTl Ij3e»> at any one luumenL 



Iniermpt handling 

On Uic Apple llfiS, inlcmipla may be handled at either Um nrma^h! 
oe the software level The built-Jn Inifynipt handeri ane in rifmiwsre 
fsee jiflpie ffCi FlrutmarE Kefin^nc^, usef 'Ifliialieil IniefCUpt 
handlers are iofrware and niiy be msciilltJ [hrcojgh ProDOS 16. 

When the AppJe llfiS detcta an inlcmipt thai is la be handled 
IllfOiIgh PmJXaS ]6, Li dispaichet caeailloin Ihrotigh ihfi Irilemipt 
vcdof a,t JCO D3FE CpJ&e 3 in batik leni). At this poinl the 
■micrcyprniXfiiOr ii funning iji cmulallon. mode, u^lng the siandu'd 
dock spetd and E-bit icaistcns.. The vaav at 40& OittJ llM Wllv 1^™ 
address bytes- in ordef to allciw iCf^Si TO alt oE Apple HGS memory, 
il points to ancflher bank w,o laCaCicm. The vectot in ih^ location 
ihen pusses CdntKil lu ihc PjdDOS 16 intcinipt dlspaichHsr, The 
tntc-rrupt dupalcbm swllchea ihe pfwessof l-u full ruiive HHxle 
(incEiidiina highi>r dodc spc^ and then pcLls Ehe uscf- ins tailed 
liilerfupt hactdlera. 

FigLjn-4-] Is a almptlfied piimiu <if whal happera when a device 
p^^raKs an inunupt thai is handb:d ihraugh a PtoDOS ib 
JDie-jTupt handler 
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tWfS-3FrTF 
iriBorJi Kin 



BuB-n 



1 1hc tili-ri-.C <" e« lOI'-ti-J 

biFm^l i! ncrdkadtTT 



3 






JVfi 



PKXXBI5 



Unclotnwd htamifsft 

Ka umJ^tmad inlvrrvpt Is iJelined as iht condldon in whidi chrc 
hinhwaiE Inicn^pi Requcsi Line- (IRQ') Is active dielns puDcd Edw), 
indicatirvg Jiw in i n [ettu pi- ft oduciflg device needa anendon, bui 
nurr of ihr insEiIIrd inlcrrupl handltr^ dainu rcsponslbdlity far tti(? 
intflirupt, "JfTicn sn Ifwemjpt "XOpu and PtoROS Iti can Und mo 
hindlrr En ciiLm il, il assuinrs that a srricus hardwaic crmr tta; 
Dcnincd. It Ls^iifi a fital errrjr me^saft? try the System Fjll^fe 
Miffligtt (set ,1fl(iJi' //fJS TtoJtynx Fc/ereitceX ami amps 
procc&^lj. ihc cuj'ECEil: app]ii:alJDn, PciKctL^in^ cannnt r^^mg mitil 
Uie user retocu iite system 






UrchnnHOlniBflupt (ololiKiar 



hafder 



Mcncjei Pnx^fw ir.iBiiu[y 



mrarrupt hantJIng Ihroual^ PraDOS 16 

PtoDOS iS SUppg^ta u.p lO 16 user- ina tailed mtCJTupC liandleis. 
'BTicn am InlfTTwpt oloms [haC ii not handloL by (irraw^are. FloPO^ 
ift tcsn-^fcR conlEvI [O enJi handler jiic:f»5slvcLy u mil HSfii: af ibem 
dzlins tt. There ls no grouping af inlcrm]HS ifitn classes; sheii 
pj LoriCir nuikings are icficurd imly by ttie ortter in which they are 
I«i:ed 

U ynu -wriic sft Lnienup-hardlms inutlnc, lo malts II aalve you mutt 
IrvsUD Jt wUh ibt A;.LQC_iNt£WJ'JPT all; lg rftiMCive 11., you mua 
use [he DERi.i,oc_iraTEriPUPT call. Ue sure to enable ihfi hiriivati 
Brncritsng tfic inierruj!* only fj/?^' ^^ itJuttne to handle it Li 
BUgaicd-, likewise, doable ibe liiariwin: before Qk rouiinc b 
dcalldCilwrl. See Chaplcr 7 Eof (uflber idwaUs on writing •"'^ 
uutalling interru[ri hitidlers, 



AS 



Parr li howPrirfJOS la Work* 
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Chapter 5 



ProDOS 16 and me Operating 
Environment 



i II 



PraDOS 16 I* <ine ot Lhe mlr^y compontnte Lhai imkc up ihfi Apple 
llriSopEiSllag eil*l"JD™ciit, ihc liverail hardwartf and nciltwarc 

sPLlina wJthLn whithAppIr IIGS appUaliurt praftrams mn. ThL* 
dijpier deK:iLbGs hi™. PjCiI.KIS ifi fcncliun^ in iTiii cnviinnment 
and hnw Ll rrlatiK lo (he mhcr ctnnponenis. 



Apple llGS sYsiem disks 

An Apple llr.SByNtcnuiisk La nJisk ■wn.UJmnB llie system Koft^-are 
needed W lun any applicitLim you wish IC> *i;ejniSc Most Sysmrri 
diski conlaUi one ra" both opentlnB systems (ProDOS 16 and 
3'(dDOS fl), ihc SysKin Lnadcr, RAH-baieci rool scSs, ElAM jsalchcs 
to ROM-basel taol sas, Ecjncs, desit a-cccssojics, boot-Miw 
initialrralinr prujffanis, and possibly urvi Of more ippliCiCions. 

"niece irc two bisLc [ypes oF system dlaks: sempi&e^-^'^ni disk* ?nf* 
aplMcatiOrt sySt** (ILiks. A camplcic jyAUstn disk has a full SSt nf 

Apple ncSsysEfln StAwjre. as LMwl in table 5-1. |[ ii a rcsoLjrte 
pool frum which ajjpliatiDn lyiKnJ dijHs can be cansuucccd. An 
ifip]icati[)n EysLcm Jisi hw nnc or mucc applicatlrMT. pragranvi artd. 
only lhe speolic sysKm syfi-wjife it needs Lo tun [be ipplieationts!). 
For ejtample, £ word prctessoir iyjirm disk nuy indudc i lilPJo 
scleoJcin af fonis, whereas a spresdshoci. syiicm disk mvf have only 
a few fonb. 

SuTlware devefoppra may rrcalc application system tlisfci for didr 
programs Ll^eft may alM crcjtc appllcail<?n system diaks. pSJhipn 
by 4:ombinma 5cvfi«l iflcUvldua] applifaUon disks IjUo a muki- 
spplieaUckn system disk. Apan rrom ihc CHcntial ("Lea LUicd in tible 
5-2, l>et« ts no single scl oF rt^uired ooflleniU for ipj^iGHlion 
Byslon diskl. 



Compl9^« system disk 

Kvery Apple litis user bnJ tfcvelHipcO needs al fcaSl i><!^ comptelc 
syiWm iii*k, H k a pool of svsLcm sufni'jire rcstKirccs. Ichl ««>■ 
Cfniadn Piles miSSinK Tram any □!' ihc ai.-ait3tk; applicaliun syaltm 
dl^u. Table 5-1 Ikuj lhe (xonems of a complcije jysKf" disk 
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Canr«nH ai a coirpiere Apple Was sys:tann disk 



1Mracla<y/nia 



DvKilptlon 



system; 
?« 

STAKT 
LtBS/ 
TOOLS/ 
TOUTS/ 
DESR.ACCS/ 
SYSTEM. &BTUP/ 
TOOL. SETUP 



BASIC. SYSTEM 



a [raitlnc thai lg<i4-s ^ ^»p«r uprnilni! »yUBm and hIeos in appliucion, 
boih ;ti bijoi Lime and whsievcr an. applicatian quia 

a Eubdircclniy lOjinEaJning. che Tl^lDwinB Hles: 

FroDDS 1^ openilng sy^Lcm and Apple 11^5 Sysiccn tQaHer 

lypLcaLly i fwoRram ielector 

a. ^ubdln^ciory fDincaining Cnc sCandud syslcm Ubnricg 

a. ^libdiceaDry cnntiLnlrig ail RAM -based too1^ 

a subdlreaciv curtLaimng iLI fcnis 

I Subdircrlnrf otniairing, s,EL drs\i acceiforici 

B jubdincctQFy cmrtiinbng syyem InilJaliitdilion pnogrlras 

a load iJie conulniirk^ puch^s Cu RDM and i ptogiani Lo LnataCL Lhcnx Hiis is 

Iheenly >T4JM(rfti flic in the SV3TEM. SETUP/ aubdifeaoTViilLsftieojIKl 

before any aOvn thjt mav be id the aubdlieiUMy. 

The AiP^Mfl QA5IC syslcni inlcifaiCLE pmgram 

The ctimpL^L* sywem disk ii- an SOCK byie, daubte-atcted j.S-indi 
dijhtcK', ;hc nrquiacd Jil» will ekjI fit on a 14QK, &iiigie'ud&d ;.Z5- 
indi diskette 

Wtien you boec i eoinplcir sfsrtin dofe, ii edvuees tt» lit 

S»fSTEM/9TAn.T. From thp START Tile, yoM may (JiOOi* 10 Cal! 

Applesoft BA51C, die an]y applldUon proven ivaibbb ati ihr 
didc. 



The SYSTEM.SITUP/ fubdliectory 

The 3Y£1EH. Setup/ subdireaory may conLam setcMl diRereni 
types at nit!, all of ivhich need lO Iw Icidcd and Irarulizcd jl boot 
llJBe. "ITiCy jnduttc Lhc fcUowiriE; 

■ Tbc file roOLilitlJP, -yyns n\e nnHi always be pmcnt: Je Ls 

prKiaElj and initiajjzes any RAM patches tQ ROM-lni^ tooS jigt^, 
AfiEi toOL . 5 ETUP ii finished, PrflDOS 1 6 ItMds and eieoiics 
the [cjnaiiiing UleMn [Ins S!STE«. SETUP/ aubdircnajy, which 
my belijin^ ic any uf Lh£ cax^on^ lisicd tM;3?w, 
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PermiHieQt biidnUiatlon fl]« IHietype S843f These Jlles arc 
loitfcd and eiecuicd pst lykc startdafd upptLnUims (lypc SIi;>, 
but tfwy an: Hot Shut down -when linked TliEy ibo mUK hiiT 
cCliaJl LhaiacICTiHi'^- 

1. Tltcy imiil be ioac(ed in nan-BpccU.1 nwmnry. 

2. Tlicy LiBiniot permanently aJJiKaw any stack/direct- pifi^ 

i. Ttier muil terminalE with i" RTL fRetum tram subcsutine 
l.cwijO rather Own a aUTt. 
I TtiOporjry InlUaliiatlon, tUcB (lype SB7)i TViMe lilo arc 

loaded and cuefLitcd jus! lik« Standard appHcaticni (jfpe. SB?), 

and Chey an! shul di>i*Ji when finblied- TTicj- muiT termiriaM wilb. 

a]i PTt- laihiLt than a OUIT. 
I Mew desk ncccMorlM (type $BB>: These filBs aiv loaded but 

Cial taecuied Tliev must be trt nfMi-spcoal meracry. 
I ctassle desk ucHsories (Wpe SB?* Th-^ fil" *«: ''^tied Iw 

rwl cKccuLcd. IfTCy muM be In nnn-spccial m^mnry 
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AppllcqHon SYS'^m disks 

EaoJl applicaUun prodram at groyp of rdalcd pff^gratiH Eomes tin 
Hi cram a ppbciliwi svBCcm dlslt- The disk hJi aU of thr iySiem CGss 
needed to mn Iha ippllcalion, but li nuy cidt hii^e all Itic filw 
pscwni nr 1 compiclE JVitem disk. DUI^rent applLati<Mi5 may h»VE 
diffcrcnl 3V*Tem files on their applLi:itLUi^ sysirm disk*. 

FOHT PMampIr, Lhe PrnDOJ ;6£jKrtuerdLsk, included with thUi 
ntanuaJ, i» an uppLlcaUcn syatem disk. [I corU-alns alt l]le jy^tem fiki 
It^d aba¥C, plui tfw IGc EXBRCISEtt {tht CMfclscc ilscll)- 

Tabic 5-2 ihowa which fifca muit te pfcaent on all ipplicitsor^ 
syiiicm disks, and w'fiidi nies arc needed only far pan.eulu- 
applicadoTH. In some vcjy icatrtcied inLitanfla, It may be pTOSitlc 
tn fi! an appllcatJnn and ILS re^uJred system files nn[0 1 5-.25-indl 
(H!)K) diskcUC; most ippMcaliums, liowcver, i^silre an SMK 
dbkene. 
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PafI 1. Hew ProDQS 16 Woikfl 
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Required confentj of an Apple 



It:; ocpllcQibn lyEterri dak 



DdrBcraiyVFElK 



B«quaK/(Raaulr«d ir..J 



system; 

Pit 

START 

LIBS/ 

TOOLS/ 

FQHTg/ 

DCSK.ACCs; 

System. setof/ 

XC9L .S£X"UP 

Basic. aifSTEJi 



rrqui red 

(.teiju'a^d if Liu? ippl^catiori is PioDOS B-ba-wrf) 
required 

(requucd \i the program Mlernnr is to he used) 
frcqwireii if ^ysicm ][bran' (ClUlijUW arc jiecdcdD 
(rcquirect if iba ippliCiUun needs HAM-hjsed looJj) 
ftequired if ihc applicaiio;! ncel^ fomu) 
frequired Ifilcsk icefaaorica arc tn be provicted) 
rtqulrcd 

trcquiTKl Lf Ihf apptitjlion u wcJifcn Ln ftpptesoTl HASIQ) 
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Impartani Tha mas PRQSOS.Peand pia oil htme verelpti numbew, 

WhBHttyntr \t toads an operating svjtwn (at startup or whan 

launcMng an appacoflon). PR03QS chaclts ths Pg or PI & 

v&fslon nymber ogalns! Its ovm. If thoy oo not motch, It it □ 
fatat leracr. Be caipM not to conslruct on appiicailofi ivsTem 
disk using IncCTrTiOlltle. verilor* of PbodoS, ?a and PLB- 



System stortup 

Disk bJodis inrt I i.iri irl Apple ncs syaem diik COitlain ita^ slartup 
ObtKK) code. They arc Idenilol la ihc boot b\acki pfl iLjrulaid 
AppJc □ syii&n dlskB (ProDOS S fl.y.5Km disks}. "Ih^ altrmr; ProDOS 
& SVSlem <lisk5 in bool nn in Applt^ lies, and it also nwiais. Thai ihc 
Initiil pan of ihe PtoDOS ifl bocbib^p pfoceduie 1» idcniii^ uj ttwl 
liwProDQSB, 



Boot IntNoimllon 

Piguie S-] shows ibe boot inttJaliialiOfl pfDcedure. Tirsi, iJie haaL 
Jirmwire tn ftOM leids the boW code (bloriia aiid l!: inio- memoiy 
ind excoile-s il. Htir a syslcm disk with a volume name /V, 
I . Thr btW[ L'i-i(fc 5cardlG5 ihe disk's vDlurne du-Etumy Ear rite Tirsl 

Ilk filmed /V/PR0T3QS wi* lh£ Tlie lype JFF. 
Z [f The RIb Is fuund, ll is IfM^ed and eirfiCilied at incatior i20M af 

bin3( 500- 

FrcMii lliia pQlniL mi, an Apple Ugs sj-atcm tUik bchavra diHaesMiv 
tram a BiafWfl:ri3 Apple 11 system disk. Dn a itifidiid App3c H s>'S[cni 
dUsk, lie 'lie nanjed brodoS Is Oic PfoQCft B npertiLEip s^-siem. On 
^n ApptR ll&s system dlslt. Iinwcvcc. thi^ pbodos file t^ noi ^c 
apcraling i>-srem ItstU: LL is ?.n iipeiatLng sySlcm loider andi 
appttcaiion s-ilector. When it receives tontiul riom The boot zode, 
/V/VRCCQ5 performs [t>e rnllLJwing, [a^kii [see ilsc Figure M} 

3. [[ relocsDcs ihc pan of ![3e]r nimMl pfiUIT w an aici in memory 
where PQVTT wQ] reside pscrfisjientlv. PQUIT contains ihc 
Ltidc rcquLrcd W terminate cne progrien and sLin aTWlhcr 
(eliher PcotXJS B in PtoOOS 16 apptlcailon)- 

4. /v/PRODOS iMis *c PrulXK 16 operabng .S^Slem and Apple 
nc^ System Loadei (file /v/5ySTEt1/Pi6: 

5. /V/PElODCiS performa artV fteccsaary bc<*. irililali7j.tian of the 
systcra, tr^ eneailing the fibs jrt The sufadirecLory 
/v/5ISTEWj'SV3TEH.3ETLip/. If ihete is a fiie named 
TOOL. SETUP in [hac subdljcciorv. ii Is gjietuicd rust— U I«»ii5 
RAM-bM«i tools and RAM plichcs in ROM Lmwd lools 
anery file It ihc SuhdirctlDry ^WSV^TZM/Sf STEM, SETUPS 
mua be an Apple IICIS toad file af type SJWi, SB7, SBB. «r SR9. 
These file lypes ire dEsmtwd wider 'The 5¥SfEK. SETUP/ 
Subdirectory," Nilfef m ibL^ diaplcr. Aftef e^f^euling 
TOOL. SETUP, /V/eRODOS toiid's inii executes. In Oirn. eveT 

(Hhc!- file thai it Unsis in ihe .'ubdiccaDry, 
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Port 1: Hew pro&OS 16 Workt 



Jl 



naCLTtA V 



1r\ [latAI 



U inin a'BaantWsfltt'' 



CtMKKlDcriCI \} 



U Kwn an* nomad PanOCA'< 



kiadA 



CneD* SidifLc Qa^^te^ 






^ DOT* FaJLja 
■UN«k£ 10 IONJ PfiOCXW 



\oaa 



vraaa 






ftcOOS IW 



nnHilBiliDn 

rVfST-5TE*»iySETL'P 



itHKLili™ lahmt lo MObOs 



rood 



t JWrfTdimlK own l"JlkjUDfOn 
<Tld bmo) up n pifnCCe B 
lyiliini nroj'orp— iftH 



B^Ei' Aetbiami 



Bopt InlUcKonan laefMtKM 
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SIcirlup program nlecHon 

6. Now /V/PRODOS Mlccia tiie!BTHi|Jie3 "he paEhnAoae nl) tht 
pystcin pru#ain or appiifa.Cion la run, Rgure 5-2 shoWl tW* 

1. w Tirst watehe!! for a type 5Bi file named /v/system/&taht. 
TypitaHy, thai (ile Is a praarim selecWr, but ii ccmid be arry 
Apple JIGS apptLcaiion IF start is foum*, It lj seleewd. 

b, tfihcTE isndSTWJT lite, /V/PBOOOS SCirdMS ttw l»al. 
vnhime dtfedoty Fijr i file i>ia« is ci[hei' one of ihc MlQwina: 

o n ProDOS ft STSwm pragrajn ^lypc SFF) -miti ihe (Tlcnaiiw 
exBtisinni .System 

n ] PcoDOS 1& Bpplicatipn (tj'pe iB3> with ihc RJename 

cilcrvslOrt .SISie 
TPWchevcr Ls found first a selected, 

* JVoI-b: If i I'fC'DOS a aystetfL pfasram is fnTund Tiril. bul the 
PmjDOS B oCMt*Un£ syslcm (file /V/SXS.TEK/PS> t iraL onihe 
ay^m duk, /V/PRODDS will then Jeatch Tor irvd sdea the firsr 
Pto1X»5 16 appliCWiWi CPraDQS iS i3 O/wajS on ihe systcoi 

disk). 

<:. If /V/PRODOS caniiDi TimJ 3i Die to cJtpnue Cfor craxnplE, if 
There is no staRT File and ihctc arc nc Pf ciDOS B nr froDOS 
16 sppHsi-iiansl, il will bring up an LiUcraOive (Dulinc ihal 
prampls Ihe use/ Im the Eilenam* o-f an application !d load 
■;. Finally, yv/eROD&a. pisses cDHIfn?] to an enlty pQiat in Fault li 

Is PQUiT, noi /v/paoDoa, iFia[ jaw?!! v loads the wkded 

progjFim. The ncrl s-SCTiim describes ihal prLJccduic. 

* ti'ate: PRODOS k^iU write an CtrCir meaMagc LO life strecn if yi'jB 
[r>'(ipboat iLonafl Apple HI campuffif Other than an Apple He 3. 
This is because PidDOS 8 nn *r Apple llOS disk is in ihe liia 
V/SYSTEM/PB. not (n Ihc file P-RODOS, 
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part 1: How ProDOS 14 Wotta 



Iroir'Bryjt iwfiaftattjn' <ns\XBi-l} 
!'i»Ho.nDin»d PRQDOSbin:oTinJj 



n \'^ni a 'IB narvta /■uiSf&KHtSIKiT' I 

(W! I re 






DC S»SIB W 



WUCh rouno ri»' 



Svji* n? rijijna fn- 



IlionDrn* 

pr^^DTTl 



to ■fllji-tmB- 



5«5rE>.' 'Is ',"",r>3 ''■■■ 



■rih[iniiH[^ 
DmCCSB 






FcilDrBTrnl: 

'no liVETEM ei 









Storlup pfVQiQrn Ml»cfl0r> 



Starting and quilting opplicotlons 

Tlv AppU? lies sUftup seq^ncE ^nd.^ nhf n cantro! a pa^rd tn ttv 
program selecLlon rouiine (PSOIT), This cauiine is eiiEered both « 
tnjQl time and whcnzvcr la appUc^tiuii toimliulvi with i PmDDS 
Jfi CT PirolXJS 8 aiflT all, 
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PQUIT 

5QUI1 a ihc PruDOti pfOgiim (JispitdvT for ihr Appli! irns TC 
deieniliiws which PrdDQS S or PiulKlS l*i projjrara is to be run 
IKKI, anrl ribs Ii M'ree stiitup. PQUIT u gjCrmJ nePtty resirfent in 
mEmorv. PQUlT load! FloPOS 16 pQgiams [hrough calls to ihc 
System Iraidtr. 

pguii hasTWDcnlry polnb- pePOUiTand PiepauiT, 'Wheiievtr a 
["rotXJS S appldcacton hcccuicb a -OtJ 1 T call, ccniwol passes thiuujih 
ihc pbpqu:t itaity poini Whcjicvcr a PmDOS l6 applicftu^^n 
c»eoj!P4 a \3mT calL. cdtiItoI paiSc* [hmtifth the PiePQUiT cnliy 
point To launch the Ctral prognm &[ SyMCiW ewmip. /v/proddS 
pajBCS conltol li> PQWIT 15 if otcaitinR a ProDOS 8 oc PlO&OS ifi 
QtllT call 

fO^IT SuppviU it^fVf V/pea. at quit call: the atandiiid ProDOS 3 
QUIT ciU, an enhanced ProJXJS » QdlT a]3, ■nd the PmbOS 1 S 
QUIT all_ 



StCT^dard PioDOS fi CUrT call 

The sLantlard PraLOS H QUIT cfill'S panraewr tlock conslsLs of i 
one-bjre farsjneEf caunt field. Cwtildi musi hive iJie valye JCM), 
foJlcw^d by four mj|] Hclils in thii (Ht^Et■. bylc, word byie. woid. As 
PraDOS a [5 rurrcnJy defined, all llelds niList tK present and all 
must he Bet to stcra. Thcrr i5 Ihus tio -waj- for a prOj^ram lq Uic the 
j[anclai:<lQUIT call tti spcelTy Uic paithnanK of Ihc fwxi pi<jgfi.m.w 



Enhanced PioE>OS » &IIIT coll 

■Hie enhantiMl ProEJOS S QUIT call dLtlcrs fnjnt Lht iWfidiHd call 
rajty In Uic permissjblc values tit ihc ficM twrt plfilfnclets tus 
plcaffrfCO IClUfIt field must sun haiic the value SO^J. Iti [tK 
enhanced QUIT call, the Ural ■OjtLc) par^nrtetej Is dellTicd a.'i ihc rJr^EJ 
4^ EMi Is ^Hi, [Kg t:3lL L« Identic^ [ to a standaid QUI? iM. \f n s 
JEE, PQUIT inlcrprMS [lie foFliJwul^ (WCrfdJ parameter ai a poinlcr 
to 3. 9trlnH whkJi is the paChiiajnc of ihe nciit piOgrsmi lO fUn. 
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Pari 1 Ha* Pri^OS 14 Wortii 
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Tlse enhifwdeil PfoDOS ft QUIT oil is meaningful anly en the Apple 
HCi. uld finly whien PQUIT l$ preserll [O iilKrpr^ tt CltMl Is, only 
whrn (hf cankputrr his bc<^ touted wiEh an Apptr HCIS syEAcm 
diSld. ]l bttuves Uke the *t*n<l4fil ProDOS S flUIT cHI in any oOier 

* Mjre; Beciuae of die way PralXJS uses fiienjcn>'.. a ProIX>S 8 
3,pplK:iUDn miisi not make 3^ enhanced Quit call (wiih i qui[ 
lype of Sl'-E^ rrom iny IcKzUun Jr pa^ 2 of bink iK iftiiirss^Ki 
AoaozDa-SooaaPFi 



ProDOS UQUETcd 

The ProDOS 16 QVLZ izaH has [miLi puamdciS: a pcintcrto [he 
pathname orihe nest program lo euetuie, and a pair ■oT boo lesji 
El^&: one (Lhc return ylei£] noiiflc& pquit whecbEr ai not Cdnuul 
shouJd. ci'cnuially iccuen [(■ ih^ fiKigram maEcuT^ itic quii ciU; ihjc 
other pn« fitsB rei(ai-^m-i«wrtioiu.iJJiig> IcB ihe System Under 
knuw wtKLhcr tl^ quJtcin.^ pragnni can be icitaned fiam nKiDcry 
when Li fCDims, 

Ifilie vilLte Q[ihe return Fbg i«ifi«e, pqlit pushes ihe UseflDofihe 
calling (quEtiLng) program onio an Lniemal scach. As Mibseqiieni 

piT:iBra.ms tun. and quii, MzvcraL Liscf ID'S may be puaticd onia Qit 
«udt. WiiH r.hia tnefhunum, mulniple levels of shdCa miy exeaiie 
iubpiOgrams and suhshcll^. ■wbtilc cnsuriiig thai thii^y t^vcnCuatly 
JTgain CDntrnL when their subprognms quit. 

For eLxampLc, ihc pjnftrdin j^leoor (STPiAT fikii iTiijl^l pisa cohikA 
IS 1 jiftCnvart (fcvckqWntJlt system Shell, usin.B ihc QU IT call [o 
Sptelfy the ahrEL and placing, its cnvn ID nn the sfarh. The sheil in 
turn ccultj hand rontinL to a debiiigger,. ti)u!ivbif puting is. lOaiTi ID art 
the 5tack_ if the dei^iu^ffv qii\\A wiihowi speclfV'fS S palhiT^me, 
■COdU'Ol ttiOuld pasa auto malic ally badt to the shell, when rht shell 
quit, CGnircl WDuJd j^ass auicntaiJcaily back xo the stab.t fclc. 

This lulonta[if iclum mcdianlsm is ^Kcifie to the PrnDOS i€ {11:]? 
call, intt Ihcrrforc is not avaHaWe lO PraCOS 8 progra-ms. When s 
PfoDOS 8 applifaliun nuats. ll canrttal put its 10 on ihc interna! 
JKadt. 
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This is a Iwief descriptian erf haw PQUIT handler all nhrec types vt 
QDIT tall Kefef jlSO tn Figure ^-."1. 

1. ]J"tPioDQS 36 or enhanced E^DOSBatPiT tall specifes a 
palhrwmc, POtriT allenipu K cwcuie the spcdEicd file, tjndpr 
ccitajn candiDOr^ itlis ma-V not tK posiible: the Pk may not 
eiisi. there may be ii^sixEISdettt memory , anrl so an. In thit "se 
the QUIT rt]l eJtecwtcf; the intEractJve ruuiine desf-ribcd bcluw 
(ilep 3). 

* Note: PQUIT will IdiJ pfQgrjms (jE file type IBJ, (B!, or SFF 

2. ifrtw QUIT caiJ spccHJes no pa ili name. PQUIT pulls i User ID «iff 
' Its internal lU slatk livl attempts lo Execute tlUL program. 

Typically, pft^grams wflh User lD'3 on ifK Sttdc are Ln the System 
Loader's dDfnumt >1?le C5ec 'User StiuLdtraiTl" In Chapter I'fl. 
and il may be pcssLble 10 reaiafl iJicm wiLhmjL relcitling iJicm 
rnjm disk IJrKlljr certain candLtlons it may fVC* tK pcHlble [o 
csecutc the progrJnl; !he !i]p may not erjal. there nuy be 
kLsuiTiticnt mcmoiy , and so Or. In that case the QUIT call 
ej«ti.lJJ.«3 (Jie Inteiactivc joutinc dcsaibcJ tie*! (Mcp S}. 

3. If ttK OUII call spedfies no pithnnxc and [he ID Slack is empty, 
pgiriT cxccutEs an inienctive lOUlJne litai aUnws ihc lisci lo dri 
any ofilutse 

n icbuot the »ystem I 

□ cMculE the fifc /V/9YSTEH/3TART I 

a enter the paihimmc of a prdgnm lo ><3ecutE 

4. ir the quialng pfOgtAAi is a PraCKDS l6 prDgjacn, PQUIT QlUs the 
itjadcr's tJsci Shutdown routine 10 placc that program in 4 
doiman*: h^is. 

5. Once It has dcicnnlned wSilth pnasram lo load, equIT kmws 
■^'hitih ■Ofjetaiing system is required. If U is rmt the cuf^M sySISin, 
a. PQLIIT shuia down tht cunent aperatirig 3>'Sie3'ii and loads Ihe 

tcquJEcd one 
b PQUIT then makes Memory M»nifter calls lo fmc memory 
used- by ihc rotmEi opccalina system, and lllocalc memnry 
needed by ihe new syswni. !F the new upcraiinj^ System is 
ProDOS fi, PQUIT allaaiLEE all spcdll mann™v t™ ^k 
pnagranL 



ti2 
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6. The new jMt^giani is laadcd. PQtJTT ■dfla ihe S^Blrm Loader to 
had PjdDDS 16 progtams, foi ProDOS S projiiiifu, POUJT 
piqsM conirtJl !Cj PidDOS B, whbd] then iijjiis iP-nti cKenjiea JB 
■own psugram diicdly. 

7. PinaJlv fif Ic is l Prt>DOS 16 proErajrO, PQUTT 5el5 up VirJoua 
aspetti of [Sc pfngram's en^JtonmCflC, inci-udlng the dii^d- 
tCfffOee mil slick- pa Lnlcr valitcs, aid plSSes OJlliroL ti> iJic 
pffC^jasBj. 






LI 






»CL«Hi|ilrH. 



Dow ("9 3AT c* IDKIIV 'no 



'■onl ID nlun Cm'' 



LMiibcn 
reluin iFiKX 



Mjf a ariBnani 
otie'iJ-riQ 



■nvTiDninpni 



4r* ll~iv(v nrFf 
■BlUlTl iloct'' 



10 



pYit ad LlnrlC 

mou rtiql m9 



lor itsname 

dI r>ei1 
DrdvaiT 



lOllCll 

'CSL-jl 



fp aotjr tnti n a L^ua i' cfiff)^9-iJ 



(Pitfoas-BiT 



PLTQe memory rct tmoH' nuadnd 
^^tilDcotD nowmdrrcfv 



MKdeaPiD^nm 



Rgur* t'i 

fiijn-1liTiB progrom wJacHan CQUtT cdK} 
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MacNiw CQfifigucrttoA tf oppllcaHon launch 

PQUiT Imtlsliae* «n*tn lurdwire and aoftwue componeins of i^c 
Apple nca iKfore il paJiea cortcrf [□ a pHi^fam. Ttiere are many 
nthei faawa ihe rnadiinc's siaie ih9i arr nai considefcd here, siiclii 
la mensoty uskI tr/ uihcr stsTEwajc and ihe stiie of ihc lia/ena ai soft 
swiidics and psemJoreftLsLcra avilliiHc an the Apple ncs. Thu 
sCt'iiiWi summiiizcis urJy Ihe ^spctts dF mjchiru? sutc iJriai aie 
eijdiciliy se[ by PraDOS li. 
■ RfSFTTEd bank $DD Sp?!^ 

Addrcaacl alxufli appraitLiiiaiely J96CO in HHiik I*.'*? 4(c rrscfii^ii 
Eot PfnDOS ]6, and [heieforc jnavailatle in Uic ipplicatioti. A 
dircdl-pige/aiadt spec, of i sLm dctcunlRcil eiitwr by ProDOS 

■ 16 gr by tt»c appli.ation itsclC, is rasj«rved fci the ippbcjuon t5cc 
Chapter f»J; it is l*Katc(l ill bank SQO at an addre,*.^ dctcxminsd bf 
(he Memory hUnigfir. ProDOS 16 requJres no other Spate in 
PAM tother that ihe lafleuag^-canl ainas in bifiUs 400, HI. SEO, 
axul SEl— »«S FigLire 3-0. 

■ Hanlwmrr reglsta^i 

The iciztumuLatJir cantairu ihe Use* ro B^gned to the 

app1[c:a[ii6n. 

■[Tie X- ind Y-irgiswes oontiin ieco (SOOOO). 

The e-, nis and it-Hag? m ihc pnaoessor status regiMer ate all s=l 

to iBEiD, meanJjig thai (he jireccEar is in fut! ftfliliw iJlOffc. 

"H« *ytJt lefilitcr conEainS the »d(tres5 of the top Of the dtrect.- 

pagcVMaclf ipxcti {sec Chipiei 6>. 

The dlrecl register cnnLnin: ihe addreM ftf fhf! hcsiom fiF ihe 

dirccl-page/slidf space Cseg Chapter 6>. 

■ Sutndud Inptit/cmlipiil: 

Few built JBi and SB5 TiieB, [be standiid Input, outpul, and ctiar 
Ittalions are sei lO thp Pascal BO-efihmft character deiice 
veclots. Sec Test Tool Sef in ^J^V* cc-'S iWu'tHK itfe/erente 

The vnJyc dF the 5hadt>w reglsW ts JlE, irtiich fflftins; 
luiguajjiK Wtd and I/O ipatCi: ihadirofina ON 
ten pages: jhiiJo^lna ON 

graphic!) pagCB: ihadowma OFT 
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■ VediM- fpare vaina-. 

Addresses bcfa-ccn iOlAfl jnd iOORP in bank S&l miMtitule 
PiqDOS Id's M?tJF)r.^t£> — Fo named tweausc ii eontaicM ths 
Entry pohi Cveant] id an PraDOS 16 caJli, It al^o Ksmiltis oihcr 
bifumiadan useful in 5yaem sorrbrtfe suth as AppJcTalk® The 
apecJfic values in appliralinn finds in the vecuH tpaea ar^ Listed 
In Table 3-i TTicsc arc Ihe only TiKed locatioiii supported by 
PmDOS L6. 

Tlw nine avsittble parhFUmc pnfrcs »re set m described in *e 



Pdthnome preTixes 

A jHlhnmc prcDz l"* a pan of a paLhnaine ihal auns With t wnlumc 
name ainl grids Wilh the name oT a. Miyiiteciury. A pirassiEnrd. 
prefi): \s cDnvcnicnt whan many (iha m the iarac subdifecioi^ are 
urctsEBd, beaaK lialiorem Lhc psthnann; r^jfeitjites, A jfloT 
p*eniKa Is convcnw^nt »>hert files In scvcial diffcreiu sybdicecwries 
muaL be rcpcitedli' accysscd The SyMem Loader, fiM cjomplc, 
titajep.i ik^ «f multiple p**?itses. Ortcc die pathname pi^«&9 are 
assigned, in aplJlica.d'jn cm icfta" (o [lt$ pcelbies by code Instead of 
liwping tiatk of all tfbe difTewnt pathnitncs. 

RroOOS 16 suppnn* ? preftsea, rcfencd lo by the pfvfbt $IihII1mi4 

a/, 1/, 2/,.-.,")/, and ■;. Oidi picCix number includes i 
termlrmiug slash la scpame 1e rnjin the jes of the pathname. A 
p«fii number at thfi begirnm^ fd a paula! pithreiine icplarca the 
ictLial ptcIlK. One trflhff preTii rumSer* haa a fucd value, and the 
□thers hjve dcCatih values a^igneii by ProDOS 16 (sec Table 5-0. 
The mail [mportant predednEid pf^fiKCK air; 

* / the hcrat prefUc — Ji is iJie name rJ the volyrrtc from whJLh the 
pccsfindy running PtoDOS l^ wjs bouied. 

0/ the default prifflj; fautomalically acacJiftd ici sny partial 
pathname [hat his nu prefix number) — il ha a value 
tfepefidcni an hciw die atrreni program was Eat^nched. In jome 
asa a ia equal la ihc booi prcfa. 
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1 / the applltsiJon preHt— it is the padinaifie of *e .luhdirectoty 
lh;«L cnntaijis the tuncntly rWfifiing application. 

S / tlK sysirm library prefu — it is the pathniEs"* of the 

subdJiectnry Con [he boo' vnluincj ihit conla ifis iJie library 
niu used by lappljcatit^tu, 

Ynur application may ainlftn the rest of the popEuttH. In fad, ontt 
yoiit ippliiaiion is ninrung. Il msy also dianac dn: values of 
preHxei D/p U, tirS; fapplicaiiocH may rjol diangc prcfu ^/X 

Prclix 0/ is similar to llie PioDOS B sysiempf^ix. In thai PraDOS 
|£ juiomiticaUy attiches prcfia 0/ H> an^ partial paduiame for 
whidi yOu ipedfy iwi prcJbt. Hoirevci, il3 mibiiL waLue is noi alwaira 
equlval.crt tn Bhe ProDtJS B iyanem pceTn's inltia] vihws. See 
Prc-DOS S Tf^hfTlcal Seferpnii Utanual 

Tlie prcfii numbcis ire sei Cawlfirwd lo specific padinimesH aiMi 
retrieved dirciUBli die 3ET_PREFlXi<.od 5ET_PFiEFIX eajls. 
AllhtKj^ a prefl* niJmb*?r may be used as an inpul iO thfi 
gET_PKEFrX ciU, prefnei «« Slii.ay9 stored in mcirvory as full 
paLtkTLam&S flhas li, Iher indudc nu picftA numbers ihcmscfves). 

Table 5-3 showa wme examples tjF p(«rii use. TTicy assume tJiat 
ptcfijt 0/ iasenw ('voLUHEi/' and ttai pcrJis 5/ Is who 

^VOLUME l/TEXT. FILES/. The p*l!inarrH3 provided by die CallAr 

& (timpared irtth [t*E fijll paihname conauuEicd, by PioDOS IS. 



tabta 9-S 

£Kampi8i Of p<r«nK U4* 



{uruppllBd 



nvitpiirtaM by ruDH Id 



Pul] pJTtirame 
prnvidcd: 



/VOLUMEl/TEKT , FIl.ES/CH*P .3 



Paitial pailiname— 

Jmplidi: tise af prelix A]: froqoS 

Bxplidi use cfprefia /ij: D/ system /fijider 

Use of prefix S/: 5VCKKS.12 



/VOLIMEl ^tSXT . riLES/CHM - 3 
/VOT-UMEl /B RODOS 

/volumei^systeh;fihder 

/TOUJKEl / TEXT , FHiES /CHAP , [3 
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Initial ProOOS U prerix valus^ 

Wfwn an Bf^Ucatian is launched, all nine prgRi numbcH an 
assigned to SpeaC-^c pathnjo^s Odjug ar^ msantnaftjl paihnainca, 
^hcfCii uJhcii m-iy t« nutl sliinB?i} Hemcrahcf. dn appliaiion 
may chlngc Iht ajjlgrunent oF any prefix nuinbo eiccpt the bOM 
prefia (*/]. Furthcnnnre, Jr some -casas certain LnLUal prefii vaiucs 
miy be befi trvcr Irom iJic picvious applicaiian. Thensfcir, bewa,* 
of assofniriE ' vilue fiir my paiUtvlar prefix. 

Tibt 5-* shows ihc initial mjues of the [Weru mimbefj chaL i 
ProDCM t^ ippJicailinT receives. ^^Kter ihc thre? cJilTeicjil 
la-unndling cDndlilcma poasdhfe <.'n the Apple UtTA. Al all ilnwi diiring 
eicoiiion, QF-TjfuME reiyriB L^K Iltefiime uf Ihc currefli 
appUcmort (icsanJIeis a( whether prefix L / hi* been chan»eci>, 
and SET_BOOT_V0t. rEOUrts ihc boot voiiinK name, c^ju^j lo ibe 
viiuc of piern •/ (icjja/itleaa nf wheihe; pieCa; o; has been 
chanii«F> 



I 



Tobf* S-4 

Inlllnt ProDOS lA prafls valuEra 



l^rofJOS 16 applicatign 
launched ii brtot firm;: 



f*)!! no. ki|h«| tifliM 



5/ 
1/ 

2/ 

3/ 
<!/ 

a/ 

6/ 
7/ 

*/ 



fuJ] pathname of ihe direoniy cofUaJning the current 

applifation 

fijil pathname of ihc appiicitiDn UhBify diipanry (/boat 

null string 
null aLrln^i 
nuJL -Stnng 
null suir^ 
null .'^Eiing 
bout vaJunM lUmt 
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IWIIa PrpDOS 1 1 prsIlK valu«4 



^•fli no. 



inKai •fctam 



PraDOS l6 appHcaWnn 
Isuni-Jicd itlo- a PtiiDOS U 
applitaiion his qulit 



D/ unduiigeti from the PfoDOS 13 iytlempfefit ureter ihs 

]Hevinu:9 applicatiur 
1/ full pathname of ttte liJretiory -oontaiaJng ihe iurfent 

applLcaliOn 
2 / ft*ll pathname of ihe appSicatlnn library dtreaofy Ci^tw 

mSums «irfflfl/3Y£TEM/LIBS) 



I 





3/ 


null string 




V. 


null slrins 




5/ 


mull string 




6/ 


rwill sEiinfl 




7/ 


null Hnng 


PfrtDOS 16 appliaUan 






launcheil after ) PfoDOS l6 






ippLi'Cati'Cirl has qjit: 


0/ 


uncfaanged rrom- the pirc^iijus appi icsticii 




1/ 


tiill pathname of i!ie direiinir cuntaining ihe 
current applii:alian 




2/ 


unchaBig^ rr<>ni the pic^Lous applicitUon 




3/ 


unehaingctl [mm the- jstvL^nii applicatEon 




4^ 


urichangec! frDtn. [he prm'iotiS appHcataon 




5/ 


undnan^d rroni ihc prcviaus appllciiinn 




E/ 


imchangeiJ ftmin the ptcvitKis appttdlion 




1/ 


uad:tanBed Tram iIik iucvIdus app]iiciti<in 




'/ 


uAdtinged imm the pievUxjS application 
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ProDOS e prefix and pathname conv«ntlOfi 

PmiiyS 8 itipptJifj a single pieRj!, Called ihc ijj/oti pnjta for 
oifTctapmj^. It has no pe^Hx njmbci — it \i aitiched 
autoniaclfally lo any pirial pBtfrn-ame Cnne that docs noi begin wfi 
a «tasti and a Vdlume name). Like iJic FnsDOS 16 prEfiia, the 
PfDlXJS Bsv^iem pnjili may be chartRCfl by J SET_PEtEFlX call 
On a sundard Apple J[. ibe derault viIlk oT the *>^liem prcfii at 
startup \& Che bom vnlumc name: tnjp'*'«vec, syScm ptugrinLi surii 
the AppLc5al'l BrtStt Ijiierpfeutr conuiiorJy reset tt>e sysl-cm ptcQa 
to ■orher valtws. 
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An applJcatmn ihac is mnnlniit under ProDOS 8 an alwiya find Its 
own paiJuurw by laoklng |[ tocatjan 3i:»2a> On bank JOO on in 
Appte WGih PraDOS a sEores the a ppJi ration 'f, ful[ or pirtiil 
pathname theeu. J'oc duuJls of this aiwi cnhet PruDOS S paihnime 
convenUons. sec Pm/X)S S TBchnicai Re/arfncs Mamml 
On the Apple IJCS, the PQOIT njutinc allow* a ProDOS R 
appUcjtion lo be Isujidicd al boot IJfiie, ur i(ier mother PraDOS B 
application hu quit, or after a PujDOS 16 appllcaUcn has (pjlL The 
tniEial valuta nf ihc ^i«m prcTut and (he paihname at Jocaiian, 
iCl2Sa arr dcpcn-Jcnl on whlcli way ihr appliciQon was kundietL 
tabic 5-5 JiSU [he possibiUiil&a. 



rcbb 5-3 

hlrloi PraDOS fl pwfe und paltinamB-vaiiiM 



lytNm priini 



locoNon *J52B0 palhnan 



PrnnoS 8 applititicin 
-lurched ai bdot tune: 

PraDOS 8 applicaiion 

liUBLtwd CUQUj^ll in 

trLhani.-cd Pioribs S 
SUIT iLall: 

PraDOS a applicatinn 
l:au.ncbed thfciiigh a 
i'ji>|'JOS. IfiflUlT call. 
'.II d'jc PmjK3S J6 quit call 
spcofied 1 j4:£( pathnsinc} 

FroDOS B applicBiJon 
liunchcilrfircmaha 
PioDOS 16 q-JIT caDi 
firihcPeoDOS 1^ QUIT cM 
jpedrped a partiffl pathnameJ 



boot Vfijuijgc name 



njtnajnc nr thi; jmSt-LaimctBid 
ip plica lion 



jndiinfled fTOm the pnevious tfwi r^ll m partial pailirame fiiven In 
CPioDOS g) appLjcation Uw emhiivccd ProK?S 8 guir eaCI 



iJiE prevltRis (ProDOS l6> 

application's pKliE a/ 



ll>e prelii spECifi&l in the 
ProDOS i6 QUIT caL 



ihc RlU paihnamc given in ctie 
PidDOS 16 suit caU 



the parlJj] pithnamK fmintia the 
preflit TiundKr) ^ven in, the 
PtoDOS ti QUIT cal] 



♦ Atafe/ Conditions CE iJirouBh C3b] in Tablt 5-4 apply QnJr lO 
PfoDOS B apfjicaijors [aunched fram an Apple lies txwfei^ on 
an Apf7l^ um iysism itisk. it a VtaOos B appllcaiion on a 
iltmdard ^fip!e JIsyMem disk Is boated on sn Apple Tcs. (lie 
Apple lies acts like a sundirtl Apple H aftd conditiijn (13 Is the 
DiJy p<34sibi]iiy. 
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Tools, finnware, and syslenn softwore 

AhhoTJljll ProPOS It Is the prindpil pi(t of the Apple CGS 
Operallng system, several 'ijperiting sv'slem-lik*" functions ?rc 
i£Ujl]Dy ciPficd 0^1 by clhrr sofni-aire cDrnponcnts. This »ealon 
briery (iestritwa mmn of those ciMnponetiia; foi detailed 
IcTumatlon see. ihc rErciEnce& [iatecl wllh «ac± one. 



Tlift Memory Monog^r 

As explained in Chapter b. the Menion' Hanjscir uJies cafe nf all 

mtfiiory allofailnri, dcallacaiJo-.n, and hoLisekeepIn^ dhcies. 
Ai^licaiions obialTi n&sded merficsTV space cither direolT, iTirousl' 
jttiueits to Ihe Memcity Maiuger, o-r indhcflly lltTQUgh PiToDOli lb 
m System Loader call* (v-hich in tLim qfcrtain the incmniV ihlOUi^ 
TCquOti TO thf Memory Manager). 

Tte MemoTf Maiias**' J* » HOM^residcnl Appfc nGiS tCiOl set; Tor 
mmc dctaikd Information oil ii_-i rundJons. and. haw ta ca\] them, 
sec Apple !!Cs TWyiliM Etjetvnce. 



1h» Syitam LoodBT 

The System LoaiScr i» an Apple tlGS tOOL set that works *-crv doselv 
wtth PfoDQS ]S and the Memory Man^tg^r ti Ji?sidi>s on Uic sroLcm 
disti , lions *'dh PraDOS i6 and olhw s>sicm Kifcwaiu Csee "Apple 
l[Q5 Sysreni Disks" in vhii chapter). Ail progjanu ariJ dsw ate 
loaded Inio memory tsy ifii: ?rysieni LcKLdct. 

Th* System Lfiaricr supports both Salie ard ■dj'iianiLC leading, of 
segrfieiited pcojtnms and sut:rnutlne Ubiarit?!!. U lc>3,dls ^l^s that 
ctjnFnrm lo a apfiCiflc rDrnilt (nbfed module format): sU-th Hlet 
afc prcidLiL-cd by the AFW Llniwr and r.ithei irfunponenls a( the 
Apph ll'QA PrC'gr^'iuTicr's Wnrkstulp llscc Appic UCS 

The Syiwm loader Li it-iaihcd [n Parim aTMs mafHiaL 
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The Scheduler 

Tlic ScbcdiiJer is n wjol set ibal fiitioJons In COrtJufieUon with Ihc 
Apple litis Heantwai Imcnupt signal foee -Sdicdulcr" (n ^pte JJcs 
Ttxtibax Sejersncet. Ics poTptwe is id coordiratc Oie eKecuticm of 
inLcroipc tmjuller^ arid mhEr LntfrrupMus^d rouUnes sudi 2^ ri.-Bif 
icceMOrics. 

Tlie Sdieduie^ is jtquircd ojily -uh^n in ijuemip[ nrudnc needs to- 
CUI ■ picrc of system sorcwaw, juth as PraCOS 16, [hai H noi 
rcmirant. jr ProiX» l£ is in thR middle oT I call when an Jntemjpt 
oeojis, Lhc LoScmjpiing joullne cannot ElscEf cdilE ProDOS l^, 
bcdtiBf! thir would disiupt the Fiis! <nm yel CUmpJeietO call. Tie 
ijfsiem ncetfc j way of idling an inicEiupt rcmiine tohcJd ofTuniil 
the syilem fcfiwarc [1 rK«[is Li aa loJl|jtr busy. 

Tile Scheduler aeeoftiplijlica Ihi; by pcjinili<a]ly checking a wuni- 
kngth flafi cilled. the Bnay-word and maintaining a qLtcuc of 
prw^eaes tint imj- be aciivaied when the Oa^ wwd is deiKd. 
EnKnupL rouQJies iti»i make operating syMem call* must go thrawgti 
lli£ Scheduler C**c Oiaptcr 7>, 



The Ui«r ID Monoger 

Tlie L'-ser ID Mmagcr U S. Mlicdlar^nuis log! set (hat pfOvidcs a way 
for prograjiut tn cihcftinr umquc idecirtiJlciiiJ<in nurabcts. Every 
memory' hli^ek 4llocatad by the Mcmoiy Mana^rr is matliijd lujjji i 
User ID l3ih shutws what s>'stj35i joftwaie. applicatian, of (|«jk 
loijsssory ii belangs in. 

Pan of tadh hloct's i-bylc Cse^ ID u s Typ*ID Etcid, deEcrlhing [fw 
cateficity of krad Segment thir fx^updcs iL All ProDOS 8 and 
PfnCiOS 3& blocks are :yfie 3-, System Imtint blixl« ace type 7; 
blddcs df controlling programs [such as s shell or swildierj ai« type 
2; and Mi>cts Mnlaining ^ppltcailcm scg;ncnts aig tvpe ]. 
Appertdix a dLagranu &tt; fonnat far tlic tJs¥r ID word. See 
"Miscellareoua TortI Stii" in Apple IlCS ToGibox Re/ervjice for 
Tunhcr []e tails 

ProDOS 1 & and the System Lojttei rely an User ID's ro lictp ihem 
restart Or rdnad applkjiicnia , Soc "Quli Prisgeduft" In tkls chapiei, 
and Tteacait" snd 'User Shuidthwji* in Chapter 17. 
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ttia Svttern Fallura Manager 

All iaul crrara, irdudina fatal PkiDOS IS Crtors, a.rt- roulcd 
ihiDu^ the Syslcm failure Manager, i Mistcl!*iner>us Tool SeL It 
displays a dcfiulr imissage on the sown, ar, if pa.«*d a poincfif 
whfir ii ia called, dwplaya aft ASCII string wl(h a uatr-chmen 
incBi=iBe, Pzasum cMQiiinn haJts when the Sysietn Failw<* Manager 
1$ called. 

The System Failure Matiagcr ia de.wiibed urdei "WJirtiUncrus 
Tool Seia" III J*WJfe J!^^ Ti^Jbax fl^rEnce 
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Chapter 6 



Programming With ProDOS 16 



This diapier pjcscnii roquircmeriu and suegestlons for writing 
Apple Il<^5 programs. Utal use l-'r&DQS 16. 

FrLUJTJiJumms suggestions for [he SvstEm Ujadet are in OiapH^r 16 
of this manual. Maic gewfal mrurmaUcn nn how lo pitignni f^ 
iIlc AppLc lltiS is ^ivaOablc in f^g™'"'"*^ /H/nsJueto" m the 
A^k JIGS. For LiriBuige'Spcci/ii: pfo^amininjs trisvudions, 
corMuh Ihe ippTuprlaffi larguige manual in [be Apptc LlGS 
pfoarammcr'fi Wof luhop (see "Applt: IIGS Prijfirammei's 
Waifcjhop" in Ihis chaptefl. 
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Application requirements 

As tfseil in ihis. manvsl, an ap^MoJlon is. a Wtfiif Icic pwgnta, 

typicallv dlled b^ a user., tlut caa irOlTimmiicalE direcLLy will) 

ProrXM 16 and any tUhcr sysicm. software or (Imiwifc ii nesii- Put 

ciarnp3e, wofd pr<x-&S&<irs, spjcuJaliiWi pfogr^ma, lUid 

prfOS;ranimin,B-langioaRC Jrierprcters aic caainples ol appli«ti.Gins. 

DaU filte SfKl snurce-t^eide TJes, as well 3« subrauLicies, IRiiarien, 

and utilities ihiL tHusi Iw called fcflm other progf ims in: Jld 

a|7plJciiion&. 

To be »n applicailHjn. »ti Apple I1G5 program muM 

[3 cfvuisioruteaiUble madiine-lan^agc code 

a be in Apple Hcs olqcci modult format fsee Appendix Pi 

D tM fila t^pc J-QJ CspSCiatl7J;d appHtS.Unna miy hiv^ other file 

lypcs — sc* /ippcndiK Aj 
o -havcafiltnaineienuinsloiiof .3VSi6ij(ytju wjjiLiiKibeseW- 
booLini at sysicm tianup — sec Chaptef 5> 
□ make PraDOS l(i call? as dracnbed, la thl£ iHisnual tsec 

Chapter 6) 
n nbacrve ttie PioDOS 36 (JUIT tonventlons fscc Chajucr 5) 
n olbsen'c- Alt ohcr appllfiible PraDOS id convcnUora, S*idi as ihe j 

gonvEiiEian* foi interrupt handlLen face Chapter 7> 
3 get a]] nccdeil memory Frum (lae Mcmury M*naBpr Csee 
Chiptef 3J 
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Mwl rather aspccLs of the program irt up ip you. The rcsi .nf iIil3 
diapitr preaeflw CDnvgnilofis ind suflgesiJorM to be\p ymi create u 
eltldefll and us*lbl appljcition, coruultm wllh AppOc ITGS 
prqgrammLn^ tonccpta jj|<J practices. 



Sfack crnd diract page 

in ih= Apple l]r,5. [he 65Cfi\^ micrapmcwsor'S .SCack-poirtKl 
i^glHcr is 16 Ww wide- ihat cnejuj thai, in ijieory. ihs hardware 
sack ntiy be loqalcJ anywhcic in twirk SOO of meniriry, and fhe 
3Udt miy be 13 juudi as ^K byua iksp. 

Iliij dlrevt page Jk the Apple llcs equivilcnL In the standafd Apple 
]I i*ro p^gc- The clKfcrcnce U ihai fi nra?d nnt be pjgc awo Ir 
memory 14ke ihc slack, [he dirr^ page miy thra?recicaJJy be placed 
In iCiv uniuiiKl arei of hank SOO— ihc mJetopracewop's dlwo 
register is 16 bits wide, and i]\ wiu^jafit; (dinefl-psge] addj^sscj 
are added is fvJT^eta lo th*? co^tenis dE (hai renter. 

tn praciict. honrew^T, [hcjc are sevcra!, resuit'tLaru on avajlibk 
Spa tr. First, only [tic iawei A^K byies of tank SOO ao be 
allftcatcd— [he rest Is fGi^rved for UO space and sysicm schv/ai^. 
AL5Q, because more than orifi fir>3£nni can be acliva al a time, thers 
may be m™* dian one swdf and mute Ihin ora? diictl pogg In bind 
SM Pur^cimarc, many applLmticsru may wjm [□ tuve paru of 
iheif code i-s wffU M ihdf sucks and duea paj^cs In bank 3O0. 

Your program should EJiercinre be is ctlic^ut as possCble in ils use 
of Slack and d.iwi-pagp ipjce. The UKal size (rf bath ihould 
ptobibly not eK<:ced about 4K hyU-jj in miJSL CMtW. 5U!L, thai gives 
ynLi [hf □ppnnijnlty [□ write prugram.^ that rrquirc sUcki ijiddug^s 
psgcs much larger than the Z'SS bytea swaaahie for tah an stendaid 
Appip ir campucera 



Aufomotte QllocaHofl of slack ond direct page 

Only you can (leddc how mudi stack and direct -page spscc your 
pmarartu «iU nccJ when U L^ wnnifigL Tli* bea time tn <nakt! that 
derision is iJoTfng prnfl/irti dcvclopmeat, when von cre-atc yniK 
source flfeM, l/vwi speaf). al that lirrK [he lOtaJ ajiWHJfll of ipacc 
iteeded, PfoDOS ]6 and the System loader will auiomalically 
ilJcicate il ind set the stack and dirctl rcgisi«Bs each cuete ytmi 
prugram runs, 



i 



Voii dcttnc yuur pruijirjm'ii stack and duetl-iKl^e reci*' hy 
BfiecifyiJig ^ 'direa- page/slack' object .^eRmciil (KlKb - S12; »?c 
Appendix D} when ydu assemble or campiLe ynut prnRrara (Ftgurc 
5-1). The sJM of (he 5camcn.i i^ die total amQiint of stack and -dlTea- 
page space yaur pragram tlieied--i, 1" « rmt il^essa>y to ciealc UhLl 
scsmcnt; if you need r»o such spate tW if [he PrnDOS 16 Jeflutt Is 
auiTident Csee "ProDOS l6 default atck and dirert page" larci in thss 
se43Jcin), you may Lt^v^ ii (ikit. 

■When the program l5 linked, it is ImponarR liiai the direct- 
pigcZ-Judi scgmcru rsot be cumblried »'lih any other objea 
segmtJiUlS to make a load ie.Sfncnl — the linker iliusl CKatc a single 
load segmenL fMCIMpDnditiR lo the dircCI-ffage/sCadi objcid 
^jjcttent [C there is era direct- pige/i-^i^ object scgmtm, [be llnter 
will not dcale a con«Sponding load segmenL 
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AtlDCOtlcn at run dm* 

Each iimc ihc praanm is siiricd, the Sywem Loader looks Foe a 
dliWl-pae*/5tack Joad sc-amtait. If i[ Hncb cine-, the (oader ciUs the 
Mcraoqi M^nAgcr lo alkita»e i p3(rc-a£LBllCil, lodted memory bLock 
of thii siic Jn bank SOO. Tlic Loadcf !Mid5 ^^c .w^^irf nt and f^asscj its 
base atWress and aize. jlctSB with ihc program's U«rj- ID and surutig 
address, lo ProrXJS 16, PfoDOS 1^ Scls the A ticcumuklDr), D 
Cdireo), umI S C5iab<> re^iera u shfron, then pusca- ojntrrf lo the 
piGBram: 

A ' L'sci ID JssJgned to ihc pf-qRi^m 

D - addfess dF ihc fu^t niJMSM-addressO tayie In dit direct- 

piRG'stadt space 
S - atfdreaE of the Is-m C^tiah™t-^Eldress) byte in the diraa- 
■ pdijGk^'dtadf spi^ 

&y ttiLs consfiiLfm. dirrct.page addjcasc* are oCrseu Irnri the baae 
or the allmatpd space, ind ihc stack grows downward fiQm the inp 
of thc^jace. 



ImpQftanl PfaDOE M orcmWes no mBOwnism for del^cMno stock oefftew 
o» usderttoM^, or cotiaiori or ttia atacn wllfi the dlraci paao- Your 
pfoaram musJ ba carelUlv dMigned and t«recl to imoke jure 



"W^en your pnjgram lemunatcs with a QlJ I T call, the Sysitm 
Loadtet'e- Applicatinn Shutdown (unflion mikcs ihp direci- 
paac/ataci! segmenr puj^paWe, ilong with the progiam's oihet 
aiaUc segmenis A.? long as that scflmem is not subBequefltltr piirBed, 
Its <^i)nlcnt5 loe preserved unsj] [be pfograjn pesUrls. Sep 
•Applbcatiori ShuLdawri' j^l '-HeaajT' in Chiptcf 17. 

• Ateft Th^re L! no prtjvisinn for extending or mDvinji th^ <Ufw:[- 
P3e«/stack space after its initial siiociiion. Betause bank JM Is 
so hcavDy ■Liwd. any addltionai space yQ\j liter cequcsi; ffliy be 
unavailable— the memorv adjoining ytnir static (g likely to h« 
(Kcupicd by a locked ir^mory block. Msks iiite ihai the amount 
or space yOu apcdly M lirtk lime fDls all yout program's needs. 
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ProlsOS 16 dsTauH dock and dtrad pog* 

11 the loader Tirtis no dlrrd-page/Mack seamen! In a Tile at lyid 
sime. li 3BtL letums the pcoRram'a User ID atvd stanuiE address to 
PioDOfi 16, but l( dpes not tall ihe M^morf MirtftSfJ ID allmie i 
dirta-pagf "Btack spice and it rciuitu iteros as the base address and 
size of the apace. ProDCfi 16 then catis the Mtuvory ManiBC' iuelf. 
and aUocases a IK dlnsci-page/'stack Bcgmsm with the followlns 
attributes: 

1,024 byus 

pro^m wth the User IP tctumed be 

the loader 

fuied 

lodged 

] 

no 

yes 

pagK-ali^gncd 

nq 

113— iMnlf SM 



size: 
tjwuei: 

ftxccj.''mcvable; 

locked/urtlficised: 

fiurrj^ level: 

may OQSS ban1< bcrundaiy? 

may Lise special mCmOIV? 

ali^nmcnrC; 

abaolulC iitj.itln.g address* 

IlKcd bank^ 



5ce Apple /las TbaSbax Jto/erenc? Jbr a genera.] description of 
mcmoiry block ailnlTUW.'; iss lined by ths Memory Marug^t- 

Onof allocated, the dcJaLiii direci-pjgc'Bitadi is treaUKl just is it 
would be if it had been ipedllEd Iff ihc piugrtilM; PinlXjS l6 sels 
the A, D, ifid S reglstai's bofere handing; CfMiCol ItJ ttw prggtam, 
ajid a,t shuHtowQ time the Syjtem Loader laiiBea ihe scjpnenL 



Manual alToccillon ol slacV and direct pag« 

Youi progTJin may allocate its own Siacic and ditcct-pagc space at 
mil (ime, if you prefer. When fro-DOS 16 nansfefs qpntrol to your 
pragram, be sure [he propim saves the User ID value left in the 
accumulitQr befMe doing ihe foUowiriB; 



Chooiei 4: Ptagnatjvnng With PioDOS 36 
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1. tijiing the auning, oj ending address left in ihc D qr S re^lHcr by 
ProDOS 16, ii should mike a FindHmdl* a,!i to the Memory 
Maniger, [Qgct the memory hanjls of ft\t a u tarn all calif - 
peovidcd direa-pagc/atact jpace. Then, mJng chai handle, It 
shraiJd get rJd of Um? space with a Dispose Han die. c^ll . 
, ft aai aitnu tJJocate iti own dafea-pagc/sUck ifUfc thmvgti tht 
Mtianrf ManigCr NevHartdle call The aJIWatrd block muai tjo 
pKTgeable, ftxed, and tocted. 

nuadlsr, the pio^^m muji plate Lhc jpproprlaic viEuea 
QieaincunE and erd addicssss ijT the jcgmcnr? In thic D arwtf s 
n^gisters. 



Moioomg system rMourcet 



Various haidwan; ami software Fefttlice! of the Apfric TG5 can 

p«Jvidc an ippliallon ivj[h y^fiil inforimiSBn, Gi Gin oQiCfwisc 
inoipise ii3 ftcribiLty, 'Iftia scalon su^gcsls nrjys k, use these 
fcjtUfes. 




Ufldcr PmTXJH 8, a Tijied addm£ ^nbaJ pose mainiiins ihc values 
of UnfiOitajnL k'aiijbles and addi«sscs ifar we b>- applimdons. The 
gJobii page Is at iJtc Hme addicM in 9 ny nuchJne or machicK 
configuraii'Hiyi thai suppaTt PrnDOS a, sd an appUcnTon can always 
■«»55. ihcM v-idabJcs ic ih* sime addresses, 

ProDOS 16 docs noi prenride a gl-diai pa^. Sjch a set nf JiMd 
loealinns Is lucojislstijfil Twith the (lejtiLjl* and dvnimiC mcmgiy 
rajni^cmcnl syaiem of rhe AppJc riGS, [ruicid,, caJls to PctiDOS IS, 
look, or rinnwajig g^ve you the iufoimation fonnerJy provided by 
lhc RlDbal page. Table Ci- 1 sbmra the ;\pple HGS Lalli used la obtaiM 
inEntmaiian equivalent In Pr-cjrJOS fl glabaJ pigc values. 



labta *-l , , , . ._.„ 

Apple 1135 .eqiJwotent* to ProDDS 8 globol paofl infoirTicfleri 



Slabol pas* imafmeHpo 



AppI* Itgi EquhidBlnl 



Global plge Pntry pfnnu 
Device diivcir vcttors 
Usl of active devices 

Mcmary Map 

Pointere In I/O buflcrs 
Inteifupi vectors 

DBie/Tlme 

Syjtcni Level 

HUCHTE 

AppU'^tinn version 
PidDOS 1^ Verainn 



Cnol jluppQcled) 

Cnoi auppnitEtf) 

fcr-i(iKd by vqlime call 

(PrCsDOS 16> 

(r^spjwijibility oE the Memofy 

MAfl^ger!) 

reauncd by OPEN cjU ffroDOS Ifil 

retumed b)' w.LcC_lKTEaRiiPT aP 

(fv&nos ]6) 

returned by n«oaTiJiie cb]I (Miw^ 

returned by GET_I.EVEL tall 
tProDOS 5fo 
(n(it suppcnttd) 

fecumcd by <3ET_VEa5iCiH cill 
CPiuDOS 1ft 



Of cwurae. ihe Apple llc;& alwifS. suppctts ihc ProDOS 8 .globll p8= 
uAcn a Fn3£XiSSoppliuii\!m H runifl^ 



Praflxes 

Tlie nine aviLlabb pierixes ttesciibcti in Chiptcc 5 oficr 
CDnvEnlEnoB in COtJliiB palhnames and fbeiribility in writing for 
diffetent system and ippllonJon disk volumes. Far dimple, an^' 
fifes on lhc bcier disk can always be a cctased thiough lhc prcFis '/, 
ic^ardless of (Jic volume rtsnte of thai panicular boat diik. Any 
Ubraty rautirr in the syslccn library su&dLpcaory will have the pfefli 
2 / , reaanllf-Si OT ft^icti sysLem disk U on Line (Linless VQLir pio^m 
has changed "hcvilue srf the pfcfuJ- if you put routines apeciflcto 
ytjur applieaiior In die same subdirectory as youf applicaiion, tiny 
an always be caJLetl 'svitli the picTu 1 /., regardless cf what 
subdirc-rtDr>> Of disk yaiir piogratn InhabEtS. 
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Your applicaiJon an liways change ihc valucis oriny of the parfiircs 
e^oepL • A Fdr example, it nuy change prefiic ij jf ii wuhru (o 
aniSE librahca (o» iny ullher He?) on a volume ether thin [tic bcnjl 
voluftM Bui be carcfiiiL nnce you change piclU tV, Tor ciample, 
jtsi can nn longer UJ* i\ IS Lhc applii:jtiDn pn^Eix Be sure (O save ihe 
vghie of a pfcfii numtnu- before vou diange il, if ynu may want [o 
n^cDwer it Jater. 



NatEve mode and vmulotion mode 

Vijii ta,n make Pf dD05 lb ea[|:> when lhc praccssnr is in «iSmi 
cmuSacfon niiirJe or native mode 5o if pan of youi pmgrim 
rwjmirs the proce-SSOf I'O be in cmuJalLtin diki^, you rveetln'l icsct JE 
to nslive niLdc bdbtc gallJiig Pfo]X>S ]6. Hawcvx;r, etnulJlion- 
modc calij to PioDOS 16 must be rti^de /fopi &i3w4 JM a^d they 
csn prefeicncc inEmmaUcfli Csuch as parimctcr Wtwisl Jn birik SOO 
□nly. Funlvernifjie. inierniipts must be duaftfei 

PrchDOS B programs run enbrcly in emuiixi'Ort mijdc. If you wish m 
modif); i ProIXS a program to ru n nuclei ProDOS 16, of if you wdsJi 
to use Apple IIGS EEabife^ unilibtc onJ^ In native ptwxle, Bee 
"Bcvislng I PfoOOS B AppLicalian Tor PtoDOS 16" jn [his diapie*. 
Set aLsfj /^gfOSWS«;j-i J>[JrtidHfftoTO iu (,l]f ,i^ /jica 



Setfing initial mocKlne cpnAgurotlon 

^Uei] iri Apple l](]5 ippliaiiDEi (type Sii) is Iiri iiuRehed, tti^ 

Apphi UG& i.i in fiill nalivo mixle "i[h graphics dudowlng oflTfsee 
'Machirte Canlifpirjtlon II ApplicalJoTL LaynrJi" In Chlpicr Si. lE 
yntir pcDjjJim 4WeiJs a ciiflcEcnt miehtrw Configuration, JL musi 
make [lie propel sEiiln|[s oncc bl Ealns cantml. 

ProtXJS \i dues nol initial iie SoFt E^-ilchci, fimiwafe ffigis'Icrs, oi 
anif tiitdwatc le^ijteis other thaji ihnse lisied m Chapter 5. Vouc 
program ig luporuOdc for ifUtiabnng any ncvd^d iniflich« And 
reg!»eTV. 
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Atlpcotlng memory 

All memory il^ocaiJon is tlrjiK througli calli lo ihc Memnry 
Manager, described In fppie Hcs Taciixix fts/erpn£^. Memory 
9|»C(! yau rcqut^C may lac cithei movable ra" unnniiju*bfe ijbrcd) IF 
it is movable, v™> ancrss i[ [hfOUgh. a rnenioiv handle^ Iftl is 
uEiruncn/ihlc, you may accKM it throjgji a \atni\v ca ihiwigh a 
ppinlcr. ^'[n<A the Memory ManlfJCr dOCi I3DL CBLum il ppinlEi" 10 Wl 
aUocaiwl Wnck, you obuln the poinicr by derefcrenclna (he handLj 
(sec Chapier 33. 

Pr(iDOS 16 paramacr blocks are referenced, by pOirlKtSi If yau do 
not code Ihcm Ln([] yrair program scBmcjiTs and lercrcntc them 
with Utxils, you must pul them in urmmovable memory blodts. S?c 
"Scitlng up a P*iamctcr Blods in Memciry' ■" Chipte' *■ 



tooding onofhqt program 

'J ycu dc rol ^'alii yt^ui proftram to load a noifier progrtffl when it 
finlsTifM, It sJiriuCd tise it ProDOS 16 CUIT ciil widi ail paramdctiiet 
(□ 0. The QUIT foiiilne peffarms all nctcstary runttions to shut 
dowifi the owreni applicaiion. and iKMmiLly bringa up » ptosraoi 
sckciDT whidi ilJLnvi the user to dicinac ihe nettl pragtaiL 10 Itad 
Most. appUcaiJons function this way. 

H*i™ei«), if y-nu want your appll«lJon (olnad and exHUle inothff 
ippUcation, iliere are -several ways lo du it. If you wish lo pais 
control pcrmammiSyvj itiothei applicadon, use the Pra.COS Ifi 
QUIT call wjLh only a pathname poinier. a* dcsoibcd in Chap*^ % 
If you wish ctNiIr.ol to tvium Ifi your ippticalJOTi ■onw the ncKt 
amilicatton Is nnishcd, ose ailio the rerurn flaa pirameier In ihc 
QUIT c:alL. Tliat. '^If yOLi' pioHram can fui^CliCifl SLmUarEy lo a 
shell— whenever ii qujis to another specified pfugjam, it knciws ihu 
ll wilJ cvcntuiUv be re-cjiecuted 

M yuu wish tc toad but nrji necessarily pi« cotitroJ lo sfioiher 
Mo^m, or If you want yuur pro^iam to rcmaiiir in mftmory afltf I 
piUMS L'nmrol to .anoihci prugram, y-'se the System Loaclei'* Initial 
Load hinchcin (described In Chapnei 175. When your piusrim 
actively loaffc other program fite*, it Is callHl a rantn>IIlQK 
pra^fiOL, the APVP SheK (sec "Apple IIGS Pro^ammer's 
Wotkstop" In ihis diapieO Is a COntrpHing program. ChaplCl I6 
gl'wcs suEgeetlons fur wrliing conlrolUng, prO^nmiv 
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You cin Load i VroDOS S applicsLkin [type SKF3 ihrangh ihc 
ProDOS 16 9UTT call, hill you aiWiX do Sn wilh thi! Sy^wnt 
katlcrs Enitiil Load a I], \}te System Unc^er ik'lll loitl dniy PiaDOS 
16 load files (lypta Saj-jay 

* MMfr BtaiiM ProDOS 8 wflJ nffl: load type SB3 flies, ProtXJS 
S^buficl ipplfcaiioni [hat luitl ind run otiifii jpplicaCions 
(tinnoi i^n any PioDOS IQ applifaiioiis. Ttyta resiiictiofi Is a 
natural tDniiMfuenfiu njf [fit lick □( downiwrd CiinipaLbality. If 
yau ivah n) niotljfy m oldci applJciiion, [n be ahk: ta use It wjlh 
PralXM ^6, see -ftevlSiriB a PrnDOS e AppliciUCifi for PraDOS 
HS," laref in ihis chipter. 



Ul^lnterrupls 

ProDOS \(i pruviiicg ccnvoniinciii tsce Cfaaptci; 7> la ensure [hal 
truemipi-hianrlLjjig rouiirtfis will Ajnctirn correoly. If you are wriiin^, 
E print jpottlcr, aam?, {flmmunicaiians ptngram or Dihcr mvane 
thai uics inteinjpu^, please (nHow ihtMe I'onwcnlions 

A« ^pl^iined in Chapter 4, an UrUHaljned im^m^ cau&ca a sy^m 
Tailure: rcintfol i5 passed in the Sviiem Faitiiic Manj^sr and 
eiieeuiitjn halt: Vaur piDBram may pass a messigc lo [he Syaem 
Failure MsmgEr to display tm [tie screen when llla[ happen;. In 
addilian. hcause [lie Sy&lEm Failure Miciaaee is a tool, ailil hcausc 
aU looJj ma.;,- be rcplatcd by user-written rUuUnrs, you may 
substitute your own crmr handler fai uncJaintecj inicnupti. Sec 
j^/ipfe /ATS TuoVbtK A'fl/eflmte fur inTonnatlon OjI the Sysitcm, 
I^ilurc Managei and icr inii/ucilOnS on, writijig yrjur own [aa[ set 

If PruBOS i6 Js calkJ while ir » tn [fie miilst of another fall , ii issues 
a 'PraDOS ii busy' cnor, fliis sdtualiofl noifnally arises only when 
in JnEcjTupt hinijfcr raaliES ProDii5 l6 calls, a typJcuJ ipplialion 
will always find ProEXIS l(j free tn accept a «]!. Chapter 7 prnvides 
insirudians tm how w avoid thl*; etrur when wrJlinfl ml^enup* 
handlers; rMvemhcLcM, aSpVQgiarns fhoulil bc able [q haiufle the 
'PfoDOS lE Imsy" cwar code Jn case n occurs 



Accessing devicat 

Under PralXK S. blo-tk dtwoMS 00 Apple U cnmputpra arc spctirted 

by 3 unU pwrnit^ ii^lalcd ta s\.oi and drive nujnbcr (su Ch M Slot ^, 
drive ]), ProDOS 16 do&s [wi liirealy suppoit that uumbcrLi^ 
system, Insiead, li idetitifics devices by lietAce pjwmfcN?^ and devcs 
name. Ai explained In Chaprer 4, devte numticni ajc- assisncd in 
order of the device search ai ostein stauiup. and device rarucA arc 
assigned acourding [o a ,iimple PfoDOS li coflvcntjon. You must 
'use dcvi-o; nuirnt^iqr^ or rames in Fr'nLL>0& \(i d£V1Cf calls. 

Fot filiuft tails and Ihr one device call (GET_DEV_NUM>. ynu may 
iLso izasss a ifevjtM ilirouBh il« tiame ofihe volume on die d=«icc 
In addition, jmu may u.w the GET_]jAST_Dev call iQ identify ihe la^t 
, devire a-uf^.^d, m case you wi^h 10 aoees; Jl Bgsia 



File creatlon/modlll cation date and tim« 

The information in this section is jinpeiEtartt t(i j'Oia if you arc 'ftTidng 
a nie or dial; unlity progrim, or any rouUfie that copies files. 

All FiplX^S 16 niee arc rpaifucd wiUi the date and lime of [heir 

creation. Wlieii a EUc is firat created. EToDOS 1^ stamps Ihc Filc'i 
direaory erttrj- wiih ihe ojmst^t date snd lime ficm the iywem 
dodi. If the illc ts laitizf modiftcd, PrnEXDS 16 ihcn stamps it wills » 
madifimJon date and lifM Oh eeaiion diie and djnc remain 
luichangcfO 

"TTie CRation and mcrflillcadort field* L(i a lile enirv refer to lhe 

fawilenls til the 13a.. Ths valuer in these Ctdds fhoutdl bc ChlilgMl 
only if the ccmufnu: of ttK fJt clunge. Since diut in th@ file's 
directory emiy iL'iclf are not part oS Lhe flic's ccnicncs, the 
modificalicin Tteld ihoulrl nol be updated when another field lji the 
file einty o n^anged. unless that chsn^ u due in an aliciaiitwi in 
the file's cnntenu; For C!xampte, a change in the tite's name ii nM i 
modifitaliuii; on tine uthcj hand, a chan^ in [he file's HOP alR-ays 
icTlciLls a chart};e in its contents and diercfaic is a mcdilicaticin. 

Rernembej' also thai a lib's eniri'' Is a pan af the cunienis of [he 
diitfdlciry or subdiifiaory that fl^ntlicta thai Ofaty. Tltw, whenever i 
file entry Ls changed in any way twSicther or nol ils jncKlifi cation 
lidd u changed), die rrLudiliCaliUTi lielda in llM entries, for ?tl ■C-'v 
endtffiing subdicvctcrri^f — intJuding the vpliime diicdory — mu>l 
bc updalc?d. 



ChaptBr 6. PrCfl(orn*T*>a Will. ProDOS 16 
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Finally, nben a (ite 1j copied, a ULlliry pragtam mu3[ be sure lo give 
itir i:'i::py ihc same oration and jTUMlU*Lcilicin ditc and timf as thr 
Dr{f(iasl fite, and wK the dau and Lime u which ihe cop^ fu 
o~caIcd. 

I'D linplBmeni these cDncqpu, £]e uiUicy pmgcuns itiould ncu the 
ELaELnwIn^ prwedures; 

3.. ^i ih« ^T>eMiein Arid mwijncatjun fields ufihe die's eniry w 
ihe cunem. sysiem daix- and lime. 

It . Sar ih« FTu^iJititJoil ficlda in ihc ciiLrcc» df ill jubdiicCEOriei 
in ihc paih i:Dn:ULriJn(t the Hie K> Uk >ouicnt sy&lcm dat? aekE 
Ume 

Z. To rename ■ nte; 

a. Do noi dungc ihc nic's muHTK^llun Scld. 

b. Eci the mNll^<aiiion r>e3ds or all sulxlLn^crode^ in ihepuh 
ConlainmB Ihc Tilic Ef> the oirrpnt system daK and time. 

^. To alMr The rotucDia af a Mr 

a. PraEXte 16 CTinsLdera i Die's owTTenis to have been modllletl if 
any HPITE Of SET_EOE' opcialion hi! been pcifomicd ua the 
file whilE [L la Qpeii . If Jul cuniiiuli^n ha? t>9«!n in«i., »$i i^w 
(lie's mo<J ill cation ilelil lo the oiirent isystetn dace and. tiine 
when ihs' Rte is cLoeed. 

h Aba sei the mixiJJlcaiiofl Helds of all subdiicciaries in the 
palh CO^Uii^ing the GJc to the ouccnl &y:stiim d^\e- iml time- 

4.Ta deletta file: 

a. Del£ic ihc PlIc'j cidiy Athii the d[[s<:i'Q[y *t! njWbectory Snt 

CDntaJiti \L 

b . Sci the rnDdificaiion BeJds- Of all subdirectodes Ln the lUih 
coniaBijng tht deleted file lo the ojiient sy^ti^ixii dvte and 
lime 

S, IV} copy ■ met 

a. Make a6E;T_f!i:.E_itiFDc:allQn the ioasc^ 11^ >Ceh« [Tie to be 
i:apicd>, \Q get JCs creaiJon and tnodifLtLatLciiii 4ktes and times. 

b . Make a CREATE oLI TO Cicilc the destinitiDn (ile (the fOc to Ijc 
c&iiued [d). Gisc it Ihc 1:1^31101; H^te and Ume valu&s tibutiied 
In Hep Ca), 

c. Open tvHh the SOu[« and dc^sLinatLDn liles. Uk: IlEADt 8.Eid 

KBiTSs m copjr the source eo ihe deairuiion. CIchc boda fiJes, 



CJ^Qprer fi; PfoHiQrnfTiifie Wlh PropOS lA 
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♦ MrfS The procedure for copying sparse file* Is n"^'* 
KimplEcited than ihia. See Chapici 2 and Appendbi K 
d Make a SET_F riE_iHro call on ihe destmiticm tile, uiing al 
nhe Lnformation retul^ed ham SET_FILE„IJJF0 In siep (s> 
Thts sets ihe inodlfitaijon liile and [inie values 10 those of the 
sduciS lite- 
PmOOS :^ auiDmaiicalli' cames out aP steps in procBduee* CI) 
tJuwah W Ptocedujr tt) is tdw respDtuibJItty nf the flle-EBpying 
utiliCy. 



Revising fl Pfol>OS 3 appllcatlofl lor 
ProDOS 16 

ir you has-e ^TiOtJn a PidDOS S-bawd pw^ram tai a. Etandard Appli 
n ffi^R Apple □ Plus. Apple lie. Of Ap|ie UO, it will lun withdul 
mndificaiitin tin. itie Apple ItCS The aniy floUceaWe dilTefencc will 
be its faiier eMcutinn I:icfau5e ri the Brealet dock spMd cJihe 
Appie IlGS.. HOwe-e*, the pn^grtitt will nol be aWe to take ^dvantiy 
of any artvjiiccd Apple lies Ecauirs iudi as laige memajy. the 
HvjUkm. ihe mow-w-boscd Lmerficc, ami he*' jyaphlcs Siwl aound 
abiliiies. TtvLi scoian dIsciBScs sarrte of Ihe baiic alieratiuns 
netCMiry lo uMradc a PiuDOS S appJicaciofl foi [MliW-modc 
ejcoiuon under PraOOS l6 en die Apple Ilea. 

Because ProDOS ] 6 clDsely panllels PraDOS 8 In fimclion namw 
and calUng slnjcturt;^ it is. not dilTiajh m Lhaxigp SYM''™ '^"' li^™ 
ijnc PraDOS to the nlhci. But sciferal oO^r aspetli of yojr pragiilB 
ilijO must be ledcaignerf if it is In nifl in native nlCKte under PfOpCS 
|6. Depending on the prasrartl"' '"^^ ^"^ Strooure and the new 
rcafuces ytju wish id tnsLall, ihnse dunges may rtiige from mintfr \a 
■Ij'astlc- 



Mennory rnQnagemenl 

tjeciuse Ihc Apple [IG5 suppotiE segmenicd load files, anc fjf ihe 
Fusi dcd.Btii:u lo make is whtdici and huw m segmcm the program 
Cbolh (lie cjtlsinal prugriim and any added pans), an4 where in 
memoiy lo pui the Mgmentj 
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To help decide where in memory [[> ptsce pifiMs □[ yaur pcap^tm, 
crsrwidti Oui ctccGtloii speed Ls jclaicd [□ mginory lofailtia- banks 
Seo and JEl exccuic iL stindard elock Speed, and all Uic oihe* 
iMfdes ttccuie ai last dock spwd (xe Ai^iie Uc^ Hatdutare 
ffejfereTrce). Tlacffie pans of jrfyuf pio^rn [ha! arc ci^aitKl niMi 
often shotJd prt^ably go inb:) Jasi rrwmory, while Ims-uKd parts 
and i±)ia segERcnu may be appropriate in sfauidaf^.-sjM-ed racmoiy. 
Or ihe ollitr hand, because all yo goes ihiOush banks SE& or Sbl , 
pfo^Hm Jcgmcnts Out mjk« heatT use cf t/'O iisirunlims cnifht 
■work best dn standi rd^pccd racmgry, J'eifonnancs tesdnfi oExUe 
c™nple«MJ piDfiiam is ihe on]^ way to accuraicty (fc[<^rmine Triicrc 
segments should fiO. 

Mcmorr niinayBmenl mcLIicfU aiK Mmpjclely dlftererii ^nder 

PipDOS t6 ihan undcj- PraDOS S. If your ProlXJS 8 pcogfun 
CEUniEEis memofy by allocaLma i\s own memDry space and markiria 
il (sfr in ihe global page bil map, ihc PmDOS 1 S vcjsian mu5( bq 
allcrcd so thac n requrats all nfeded spate from the Memory 
Manager Whcies! ftoC»05 8 dnjca aoi chedc W aee if you are ii-ilng 
unly ynur mjf ked-trJT ^patc, (Jie Memoiy Manager undef PfODDS 
16 lulll nOl assign tu ytwr pragmm any pan of nsimufy ihaj hw 
aJfeady bc?ri iilocaied. 



Converting Kystem calls 

For mca[ PrbDOS B calls. Iherc is an equivileml ProDOS I* *a]l wilh 
the Hme fwme. f-ach all block tnust be fnwflfled for PioPOS nS: 
ihc JSR O^oip \.o SubKnjtinc) IsscmHy-lan^agr tnsLxicIlDn 
repl^teU with 3 JSt (lump lo Subro^JiJne Iffn^t ihe oiH ruimber 
Held i:iLidc 2 bylcs long, and Ltic pai3Jiic[e3~ lisl pcnntcr made 4 byUd 
Jon*. The only other tonveislon required is [he re«wisicijerJ<>n of 
ihr panmeiej block m ihe FinDOS 16 fniTnaL 

Por Other ProDOS B callj, ihc ProUOS li equivaleni pcrfointi i 
sUghtiy dLlTcjieint u-ik, And the orlgltMl code wtU have to be ctunRed 
Co 3.i:i:rajnl Eac thaL Pcii eKiinpto^ In Pr-ciPOS 8 ^n C'>l_LirfE c^il 4;aEL 
be- used direaJy lo [ktcmtLnc ihc nimcs of ai] QnUnc vaLumes-, In 
PiiiDOS l6 a siiCHZ^sicn or volume calls is itft^ird. Befer 10 [he 
detailed dcsmptLons in Chaplcis 9 throu^b 13 to sec wtilch PccDG^ 
16 alls ire diflercnt from Iheir PmDOS 8 cnunleiparts,. 

Stiif other ProPOS B ciEls ha*e no equLvileni in PnsDOS Ifi. They 
aic listed and desi:ii!it>d LimJ^i' "l^iimhaied I'roIX^S S Sv^Kin 
Ca-Lls,' in Chapier I. If your pfDBrani uses any of these caLbs, they 
wiU have to be rrp larp' ii as &hi:)wn. 



Hardware conQaUKirftDr 

ProlXJS 3 appljcatipiis rem only In filOZ emulation mode ori liic 
Apple nos. TliiL does na\ mear that applieaiioru convened |q fun 
litiider PraTXUS 1*5 jnun neccssiirJy mn in nitlirt; ntode- Ttktrt are tt 
Lean three configuraiinnj poasibtc: 

□ The progiiixi ni^y jun in emulation modie, bui msj« Pro.DOS iS 
calls. 

n The pragram mty run In niti« mode wlih the m- jjid i-bBa set. 
the aoQirnulator an4 indea rcgcstErs will remain B hlK wide 

□ The program may njn Jn full rutive rnode itm- ajid i-bju 
cleajHO 

ModlFying a ptog«m for dje Ttm Hjonllgurailnn pTOtMOlly hWililvc! 

the lc«t etTon, bui remi-na i}ie lea.it txineliL 

Modilyiiig 3 pragfim lo (un in (iill native imcxfc is the most dlfFFojli, 
bui k nukes best use d" all Apple UGS feamna. 



Mod)fvlng Inleirupf handlers 

If yi^ij ha'w 'wttuen an inietrupt handLng mutinc. it need^ id be 
updated lo ctsnform Mila ihc rroIX>S ](i ii^cemipi hariilLii^g. 
caiivcntlons. There maj' be very few cliangcd necessary: it must 
KlutTl with an RTL ■CEletiicn fmm subrautinc Infjg) rithtit than an 
HTS CHcturn from Sutwoutlliie), Ifid l[ nfuSE staxi and end in 65CSl6 
njilve mode. Sec Chapter 7. 



Convertlnfl slock and zero page 

The fugd. SKVS* and serO-pagc lucaticins pauvjdcd Eat yoiai pj-ogram 
by ProDOS 8 are not available undcj PraDOS 16. Vou may cLdicr let 
ProDOS 16 as.-^gn v<w a deCauk l.l>i't-byie spite, <x yoj may define 
t dlrea-paBc/siack segment [n youc cbjcn code. In cither egjic, th£ 
ItJider may place the se^fnefl' anywhen? in bank iUO — ynu cannot 
depend tin any specific address being within the space. See "Such 
and Dirt^ ^tgn,' ewJier Iti ihii chipter. 
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Compf iQflon /ammbl^ 

Onos your smij-cc- code has been, mDdificd and imameciied a 
dcaLTEd, you ttecid in rccompile/nesSHJUble iL You must ii,se sm 
JSSerntiltr ar ompHlef ihJE pjodtim cbfctl fil^ jr ;\pple UGS 
nh\cci module (ontai. CO^tF3; cuberwjse [he proj^am cannot be 
pfOpftriy linked jrvd Icjadcd fa-j- cxccutinn. Uflfflg a difTerenl 
«impl!er ui lascmhfer may ii>ean iJ:h[, in addition [o ftiodir]dr2 
your prngrsni toJe, rwi miaht have m chtfigc same aascmlilor 
tlire43ive9 [o fcUow Ltie svfiiaK of ihc mrw issonhleu. 

Jf you have been uslna tht: PJIASM ISicmhlcr, you wJ![ not be iblc to 
use II [o wnte Apple [IOS pnasrams. TTig A.pp]e IICS Projjiammer:! 
Wcwksfwip 15 a set of JsveJopmcnC pragiaiiu diai allow yuu la 
producp and ^[ smjrcc files, aaaerabl &■•(:« m pile obfecl files, ifld 
lint them innj proper OM}^ lo*d files. Sec 'Appli! IJQS 
Piogrammc^r's WoiKahup' Jji ihis ch»pEBT. 

Aftei your nrviscd proj^ram Lj linkrd. assien ll the [MQper Apple 1C5 
appJicaLion file type (ntjmially SB3) 'ivjth ihe APW FiLe Type 
utility. 




Apple lies Programmer's Workshop 



The Apple lliiS I* fftg/iiT liner's 'Wnrt'ihnp OtH^ b i powerful sec oF 
devElapmem jtrogranu designed In fadlitjte Lhc crcitian of Apple 
lies applicatLons. ]f you aw planjiing lo write pju^ramj for the 
Apple UGS, AP'*' wJll cftske your job muth easier. The WcicltEhop 
indinic5 Ih* following tacnptjnentS; 

O Shell 



M these componcnta wo* [OHciher CuntJer che Shell) lo speed [h« 
writing, compiling ur assenihling, and dcbuBsLng cf pro-ams The 
Shel] scDf M a comnund intcipictcx and an Interface lo PraDOS l5, 
providing scleral upc rating system functicns and fiCe utiliiies ihai 
can be called by user* ind by proBtants runrilng under Hie Shell. 



Sec the foll«wlnB manuals let more information gm the Apple IIGS 
Prajtrunmcr's Worttshop: 

D Apijle nas Ptugrammer'i WcriiiHop Reference (describes the 

Shell. fcdHi.ir, Linluer, and Detjufiscr) 
n Applf ncs. Pm^rantmer'i Watteftcp AssemNer Hefirettcs 



Kumon Interface Guidelines 

AJl people who dovclcp applit:a,Lwjn prusnms ftrr iJie Apple lies 
curtputer m iiftHigl)/ ertfOLifajed to follow the principles 
.prtwnutd in J/uraiin yjiteF^ace 'GutdlEJlKf j. The Apple OcsHop 
Iruerftice Thai manuii] de^tribu iIil- dcskbip tucr liiu:Tfatx 
IJirntt^ which the ormpulcf liser ponimunicalcs wilh his COfflpUter 
irtd the ipplialltms ninning on il. This section btietly outlines a 
few d( Ihe hunun inlcrl^ce ojna:pis% plcuc lefci ■□ lhc mulull for 
specific design inffjrmaiion 

The Apple tteiktop Inreffaca first Inifodured with the MidniD.'ilii" 
computer, is dcsi^nci:^ lo appeal Eo i na'nle[:hnical audieniK 
Whatever die puipose or awuoiure of tout appLlcailoin, it wiD 
comunjcaic wiah the lucr in a iton-^tcnl, jlandanl, ajid aua- 
ihre:;ii«iiirig]na.nner if iL adherer 10 [he Desktop lfuerf»c^ ^und^j-a^. 
Tbese are some nf the taskf pfiincJpleaL 

■ Kuiuan oonli^L Uxn should ftet chat they irt ccmtroliinA ihc 
prisj^nnt, lathcr than the icvcific. Give them dear altetnalivca to 
se]e« from, and act an, their selections constsiemly. 

■ Dialog Ihete shfjtdd be s deaf an<l rfiemJIy diaicia between 
human and computer. Make mcsi^agcs a^nd icqucsl;s lo the user in 

plaiJL Ln^lbtb. 

■ Dln«l Manipulation !tndF««iflKKfcTlKU^wt^ phy5<ca.l 

idions shnuld produce ptiysira] n^sulL; When a key I; prrsst^d, 
place d:e amespondinj^ kner Ofi Jie scteen. Use highiiahting, 
anknaCian, and dialog boxes to show lucis the posaible ICLiOjU 

and [lu:!/ oonAcquen'ti^i. 

■ EXplomlOtt: Give the user ptmu^itin lo tcM {)ut ihe pOSSLblllTiH 
ciF Ihe pro-am wilhnisl worrying abc^Jl ncjjative consequences. 
Keep enot mcssa^s uifmpjcnl. Warn the user when li iky 
siiuationb are appioathed 
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Par! k hlow PioDCO lb WoTki 



Crapblc dcalipu CiiX}d HiuplluL: dc!J|;n is a Vny EBarurc of th« 
guinJetints OLpetus on The screen ihioulii b« Unfile and dear. 
and. [hcyshciLLkt hive tiiiMat.^^fi^ (Lhii \s. they &hou.1d [:>ak Like 
wha[ [hey rtprtScrtt). /^Mtu Snd palfilltS in.- Lummun jjjaphiC 
clement? ihal need csreiEul design- 

u^i ha$ En fnrmalEy cnUa a.nJ ]t£a.vc, i.[iiJ llu.L ic^cts the 
tipcra[it>nis iJiai can be peirrcrmed i^hkle li'ii Iti *fT«i By 
lEsirJcidng ihc user'.'; dpcinris, modes reLnfoEcc [he idc-a [Ii3i 
compuitira ans unnaiurtl and unfriendly. L'ae inode.s spaflna>>'- 

Drticc-LiidcpciKlcncc: Mike ymir piOBiam as tunlwaic- 

InnJependeni « pcsslbJe Don'i E^vpsw iJwj iciok and c«oyrgM Ln 
ROM — your program miv bccomi:; Lncnmpatihtc wjtfi fijtu/c 
f [rgduOa InJ fiiaitkircj. 

Oms^btency^ Aa much aj pos^iWe, all appliations should use 
the same inCcifacc. Dcn'L canfuEC ihc ujtir wilh a dil]iei£i1[ 
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CmliLtlani Corsljtency dew not mpin that yau are restricted to 
UJiii^K cuiCinj^ dcaklop rcaCuncs. N'cw Jdci9 aic c^scnliol for [he 
i^liluuirm [^r the HLimin Inlcifaicc oitnccpL If v^^"' applit^Lio-Ji 
has a Teatu-ns itni » described in Ifu-man IfU^rfcKtr Suldeline), 
you should jmpJomwn lt esanly as dtscrlbecl; if ir « someiJiinj 
near, rmkn .min^ it cannot tv: rnnfu«<>d with in ewtlnj; fgatuie. Ir is 
bdicr Ea -de sonicLhLng complclcly diflcrcnt than In half agrre 
with ihe guld^linei 
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Adding Routines to ProDOS 16 



This chapret (fJEKU^SQ^ addatiDnat specific icuiit^es ihat may be imkI 
ft'icti PmDOS 16. Because iheat rcmilnea are dJjflOlv tannctiEd lu 
ProOOs 16 and irtiertia With it at j Lew Icinet, they are esseraially 
transparerii to a.pplif:i[iaiK and cafl bt cofisidejed 'pan of" 
PraDOS 16. lEiIcmjpE hin<Ders are the orty gurfi rartcraiorlS W 
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Intemjpt handlers 

The AppLc ntii has eitcnsivt:- (innwire iiucnupt suppon ftee j^i^fl 
//GS/^tnuuire ffe/etvncei. fn addtnon, PinDOE 16 supports up to 
16 uMr-icutalled Imemipt HinrfleK (see Chapter 4). [f yau wriie arv 
inlcriupt handlcc, iL shouW follow the C00«efltiOfi5 d^scf ibcd heit 
NntE alstji [hrr pmauliDns you mnsj tikjr if yixir haiidlci tTUkCJ 
opefulng ijviem alls. 



tnterupl handler convonHons 

InLcnupl haiuUuiB rautincs wrlUcn (or the Apple IIOS muit follow 
ceruln ^nv^ntifina. The Inlcrnjpl di^palcticr ^viU set ihc Following, 
□udnne si3is belore piiasms -cuntiul 10 an LrKemj-pl handicn 

E - 

m - 

X - 

i - I 

C - 1 

speed • high 

Before ictumtng lo PmDOS 36, ihe Jnerrupt hainDet nuui nmtaic 

the nuilhbne 10 tfic fcIlowLnB, siaic: 
c - a 

m - 

J - 1 

speed X high 



9A 



Perth How PtaEJoG 14 Wodui 



:n addition the c flag muM be cleared C- l3> if ihe fiandlcr Bcrvlced 
the inicrmpt, and s*[ (- 1) If (he handler did nci service the 

irlrmipt. The hiinflcr inuaE ictiim iSiEh an RTL ^ni^Iucti□n, 

When in tmemjpt Is passed lo ProDOS 1 &, ProEX^S 16 Rra jcli the 

ptnoeastJT tQ AiU nsEivc mode, then successivisty palls th* irtsLalU^d 
Iniccjupt hardlera. ITofle uf them wrvltcs thcJmenupi, PfoDOS 16 
Jincws because li liicdts the *■»£«[; of ihe e flag when the ttxtlnc 
iietums. irihe t Bag * cleurd, ProDOS 16 sftitdies badi tn 1 
5Undind Apple tl cotifLj^urauiun in cmulJtJon mode, and pafoma 
in RTi to the Apple tics firmwafe iniiciiupt harKfling sraetti. [f ha 
lundlersenrtceaihr inn^ffUjM, it is an urkdaimcd inteirupE anrf it wi|] 
result in tystcm ftfluie (ice CSapter fl. 



JnsfallInQ Interrupr handlers 

InlerfUpI hanrfleo, ne insialted with the ALLOC_IWT&RStJPT call 
iad nrmoved with the DEALLOC_INTERHtJPT CaQ, The ProIX>S I6 
IniernipC dlspaicher nuintdins an Interrupt vea«r ufafc, an affjy 

oTup (nlS v-caocs in irtcnupt hii,idlei3. A.ii«adl jucccisive 
ALW)C_irfTERRi;pT Q]l is made, the disjMIchef aitla anottici 

encry to the ^^nd of the laMe. Eadi pCme a dejlLU]'C_i[*tebrb,\;pt 
Gdl Is midc [□ delete a vgttor from ihe lable, ihe i^rhairans lectors 
ajt moved toward the beglnnlns of the amy. fttUjig jn ihc gap, 
Inicrrupt hSmlUinB roLilincs .are polJc-rf by Pe*DOS 16 In i!ie Qidcf Jfi 
which dicij- vccROPl Dcoif m iJie inlctfiipi vctLor labte, 

ITneic ii iTO way to reoitScr interrvipi vcdnrs gjitepl hy allocallng 
aJid deaLlocaUng Inli^mjpis. tmcrmpii ±m occur often or requiit 
fast service should be lllotaicd Hrsi, 50 their vectors orjll be ncir Ihe 
bcgLtwUng of Ihe intcmipt VH=aui uLle. if ^xm need exfemefyrisi 
Iniermpt -sefwice. liiitall ycjut iiuemipt harvdier diiccLiy in, ibie Apple 
DOB firmwatc inwtmpt dispa[fhcr, raihef Lhin thnjunJi PrnDOS i6. 
See. jVSjW* "fW /'irmuvjn' ffe/erptice for fur^ec Infarumtton. 

Be 5t>re to enable [he tiandws rr Beneniins the interrupt onJy 
*Vit* the roi^Qnc 10 handle a u ?! jotjicd; likewise, diiahle ihe 
hardwwe beJoFeiht: routine ij dcallocawd, OthejTjWse a fatal 
ufKtauncd tnrerrupt error may oseur feoe 'UnCllimcd 
Intemtpis" in Ch^pu^r -t). 
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Making opierallng systom cdtli during Lint«rrupF» 

FfoDOS 16 U not lEeittnnL Thai is, it tifxs not savt iU i3wf1 SULK 
whert iii[cinjixed. IL iherefoee Js Illegal to make an npcntinB system 
call wtiJli; imi^th^i (^peialing syElcm -i^ll \s in pE-o^cSJ; if ^ Call Jj- 
aticmpEcd, ProlXH IC will reium an enor Oiumliee SOTj "PmDCS 
J& busy "3. 

Par appClcaiJiniis this i^i not a. piDblEm- iJit aperaLing -syscem [a 
always free lu atftpt i. till Tnwrt ihem Only rouiJnes iJial arc sianed 
through Jn[i?mipt9 (^uch as jnu^mipt ttandlcT! and dc^ afcC^OrJe^) 
need be tajcM ntA la tiJ PioDOS \6 while i( li bifsy. 

One accepuble pzuceduie Li; fur Jie inieirupi handler lo consult the 
PrdDOS busy flag aL locaiion AElWBE-iElOOSF (tee Table 5-3). 
tad aimpLy nfn milie ihe sysifin a]i uiiiess ProDOS t6 is not: b».^y. 

ir in IncefiMpi hamdlef msilv rawd^ to inakHS an <:»pcfaiEng s>wLcm 
rall^ il musL be pirpored 1-n deal with a irlumcd 'ProDOS is buay' 
i:itot. if Ely.L lu^fKfy Etb£ EbaAdJet- gS^fuld 

1. Defer ilsdiT tFrn pni-arlly 

2. Hecum CdHiCiul !□ ihc opecalLng ay;^l«ni ^E) ihai ihe Oficrflling 
sydecn may ctwopiete ihe oiffeni call 

3. ncgaM central when ihc ofKratLR^ syMcm is no longer busy, and 
uaht ibs uwfi System 4311 

llic Scheduler, pari of a ROM-based tnnt sel, allcwa. tnlcrrvpt 
hanciief? w Follow these procepdures in a simple, stajidafd wjy The 
Sd^ieduLci: c-l'uhjICj a syslcixL Biuy wind Qial keeps [radt u^ rurn- 
rccntiajU sy^lexn. ^nftwaJG thai Ls in us^, PcoDO^ 1^ »»r» mir-< ihE 
Scheduler luuUne IHCBUStrLA^j whenevei ii is called, arvd 
EECBUEYFLflG hcfnfc 11 rccums rrtMTi a ca.lL An inicr^upi tiandJcj 
csay use cfie SchedLiler'* schrddtask rouiine lo friis^fi iiself in a 
qiu?ue aS ta.<lis waiting f[:ir PrciIX^S l6 ti> C0>nplct€ any f:ilLt in 

prepffiis, Sfte .^fip(e /;c; Teoffe^ss He/S'^i^s faf tleiailed 

JnfornmLlon . 
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Part II 



ProDOS 16 System Call 
Reference 



■[liis pan Qf Hie manual drscrihfts (he FioDGS 16 system alii in 
ilEtail tlie dlti are: amiiped iilEa Kvc L^t^gorles: 



D Flic liini,i:a^J(ecpLng i-3l(« 
D Pile aa:cs5. calls 
o Device tills 
n Enviranmfni calb 
a Irtemjpt contml calls 



CChaptcr 9) 
Khapter 1€) 
COiaptcf llj 
(Chapter 12) 
(fibapter 13} 



Cliapier H shows how to make Ihe caJU. ijid ciplalm the fcNntat fnr 

ihc call descripjion? in Chapicis ? Uirotiah 1^ See Appendix E for a 
liat «r all PraDOS 16 cnaa icaimeif by the calL-;. 
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Making ProDOS 16 Calls 






w 



Any indtpftldem prDjjtirn ni ttie Apple lEGS iJut makes lySiem 
cailj Lsknnwr as a Pn^nOS 1& CilHS-rtg pnigrarn cv caller The 
cutre-nl appLiCiilon, a (fcsJc ae^ianiy, and an Imernjpt hinJfef 
are eKsmplcs of fxxenliil callers \ ProDOS l6 caller tnjkcs a 
system call 'by e-necuiuiB. a tall block. The tall block ennialrts s 
pwrner W a paramelec Mock. The psrametcr Wock is UMd for 
pasidnB ijifumiation between the caStcr anri ihe called funciioi^ 
atklLIionii: i n.rQrmaLiQn ibowl Hic all H retfe^icd in the SBTe of 
certain haidwai^ fe^iMecs. This cha.pier discusses C^esc aspct-W tiF 
system cilts and cDmpirea tfiem wJih ihe caHIng mciimd used in 

♦ iVflW; The plwak-fl iyilem call as UM"! here is gytrtinyinallE *lth 

epsfottfis ^ratera ta/f ur yroDOS i& caii. and is cquivileni ti: 

. MU call Fuc fronos a, li includes all calls lo Ihe opcrsung 

sy-Mlcni fiii accessing sy^wm JnEormalifn and manipulaLng 
□pen at dosed files. R \i no4 resustied co wh»i arc LilLcd 
■sysjcm calls- In itw AcDOS S rpcftwica/ SefiTence Manmi. 



Th« call block 



A i^tem caU block mniiSLS of a JSI. Jmp 10 Sytinnutinc iWPgJ to 
the PnoDOS 16 cnby point, EoHrm'sd by a 2-byie sysiera cill numher 
and a ^-bytc pitamelee Wck* pninLcr. PmTKfi 16 performs Lhc 
requested funciinn, df possible, and cecurrk? eic^lion TO lite 
Ln.'jtruciian ImmEdlaijely fallowing lite c^ll tilnct 

All applicatififis wiiBcn far ihe Apple Hil^S undcj Prorx>& 16 
rnusi n-w iJic system call blwlt fnrjnaL Wlien making ihe call, thr 
j-aUrr may Itiv* ibe prwrLwur in emulation mode Oi Full native 
nHjde tlir any stair in bei^^^en O^^ TstJiriJCd/ hUmditcOoa m tfie 

t /Vef^fTS £J3! FraPS^ !^ V^ll!!? ry'^l?!g In em»Jia.tiDn mtuJe, 

ynuf prDEjajn nlimi be in bank SOO and inlcrrapU ttt\i!A be 

disabled. 
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PRODQS 



The fall hloch looks like thisi 

GSQV iElOOAB ,• filed entiry v«otor 



JSL PRODCS 

or I ? ^cailntjm;' 

DC li^PARMBLDCK' 

HCS EftROR 



SEtRGR 



PAHKBLOCK 



Oiapatch call to pfqdqs i£ antiy 
2-tyyt.o call nTOber 
4'byte- par.jjftBter bioek pointes 
If cacry aei;, g^j to eiror handler 



1 ferircE lidnd^Vr 



r paFaiut«r black 

The tall itkx^ itstif caiaiil;^ of on]}' the J3L jnatnjctl^jii snd ihe UC 
(Define CcTlBUinO aisemblcr direcUines The BCS CSranch oh Cariy 
SeO insuTiciimi in Oiis ciampic fs i condlUonal bmidi in jut effsr 

hundler calJed Ehrdel 

A JSL nthcc than a J5h Qump lo Suljrcutine) is irqijifed because 
ihe u-SL ii»c5 a 3-fcirw iddLcss, aPowing a dltci lo make Ihe all 
from anywhere in racmoiy llue J5H insBUaiOini jsca only i Z-by[c 
addicts, cesLnoing H lo (linips and reiurcu wichin the cunea {fr^iO 
bicick of mcnic^i^y, 



The poromeler block 

A parimerer bEodt lj a S.pecU"LEiUy fonisaucd taUe thai atcupies a 
sen or canligjjoij;3 by[cs In mertwiry. I[ Cfwulsts ^ a number of fields 

ihiL bpld infumiatfnn ihai [he casing pr(3«tam, supp-llea lo ihe 
Funtlitm Lt calls, l^ wcU ss tafoimalion, reti^rMid by ihe runeiion lo 
i}ic cs.\iei. 

Brtry PraDOS l6 call reiLpj IrK a, vaUd pu^meter bEi>ck (tMtMBLOCK 
in Ihe nminpEc just ^iue;^. icferajKxd bj- a 4-byffi pounct irj the cati 
btodt, The caller is responsible for constfudma the- panmeter 
blmi for cacti call a makes- <fie Use may ^ , nvwhcrc Cn memDry. 
FofmaLs fm inidividiial paraoncicr blocks accompafiv [tie dctaiEed 
system call dcBaiptioru in Chiipieii ? Hirough Ih. 



TV^M or poiwwlan 

Each Djcld Ji5 a paramcK^r blocJt ccnLatris 7. sinsle pir3mc[er. There 
ue three types at pajarwiers: values, resulis. and pcLnttfs, Each ia 
eiiher art IJ^JW to ProDDS Ifi frcwn the «]!er, CM- an PW(pMi Erora 

PinOOS 16 (□ iJii: ollei, Thfl minimum fcld sim foe 1 paiaraeter is 

one wo«l a byi«. see Tabk 3-1). 

u A v^luc Lb a numerical quanniy, 1 of more wards Ions, ^^^ '^^ 

caller passes tQ FtotXJS iS thitjush the paiimetei 'black 1t w an 

inpui paiamcier 
[] A reaull is a numBiir^al quintily, 1 or more wend* long, that 

ProDOS 16 places IrtEO iTie paianneEef block for the calkr lo use 

II is ifi output parumetsT 
□ 'AptHoM' Is Ihe i-bftc Oongwurf) addren ofs location 

coiualfiiig (ilia, code, in address, o-r tmfVtr space in whidi 

ProDOS 16 tan few«ve ar plai-e dacta. The puintci- ilscLF Is in 

input for al3 PiqDOS i6 csQsi the dan It points lo may tc either 

inptif Of jjiiJpai 

A parameter may tje t-Mh a vaLuC aitd a ccsuIl ALso. a pointef may 
iJesJanate a locawnn thai cOrlElins a value, a result, or boiJl- 

• filOle- A handle i» a special lypc ol" pntnter^ il is a potrlcr in a 
pointer II \i ihe ■t-byte address cf a locadon that tnei/ ctmuini 
ihc addffcSJ of a loclllnn containiflS data, code, Of buffer 
sp»ce. PfolXlS ]i5 u.se.'i a handle paiamrtcr only in the OPE.N 
call [Chapter 10), In that caU the hintSle Is an CU^!U4 trerailt). 



Parometer block format 

All parameter I'lr^tli thai ccmtain block numbcre, blCKit cDunli. file 
ofFscts. byte count!, and nthfti Tile ai voLums dlmcnsinfii are 1 
byies long. Requiring; 4-bvM: fields a]iuT&i ihat PioOOS 16 wiil 
jH^arajTodilc fuiurc larac dtvioes using gllCSt file syStemB. 

All paramete' fields cantain *fi even number of tyncs. for-gaic of 
manipuUtion by ihelS-blt 65CBI6 procesnor. thu? poJniers. for 
eiamplc. Of A hytf-a long even OiouRh 3 byres are sulTlaent 10 
address any mcmaiy liJCJUiin. Where^'eJ such catra byres occur 
Ibcy mujt be seito itra by ihe calLcf ; if they are ™a, tompatibUity 
wiih (iiDjre veisJqns of PioDOS ifi will be leopiinliaed,. 
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pfoDOS \b Systern Call R9ls«9ncB 



Pointefj lA [he pirarneKir bLodk muH be wriiicn with die Isw-ordpr 
byitf of ihe !ci»'.oidnt vioii si (he lowest iddrcM 

Compadsiun of ProDOS Iti par-amerer blocks with iheb PraCOS 8 
coLmteiparts revcab thit In some rises vh« ondcr of pwamewre a 
sliaJuJv different. These aiwraUnnj have been, maifc lo facillttttc 
shitln^ 8 sJngLe paiEmetef btotik amofig a nuinbcr of wJJs, far 
Mample, most lite loecjs oils an be made wi4Ji a stnaJe paramcEr 
Hadi for e*di open ffle; under PioDOS 8 this ahaiing of partmetcr 
Uocks i^ HGt prus^'ble. 



Impofitirii A parofnetai"* ftald wktiih In a ProDos it paronwtef blocl* b 

often vwv dlftofanl ftofn tfe rqna* of prttnlEsfcl* voJuob far Ihat 
porem-etei. Th» lact hhor cii najaa ore on «>.wi rnjTTti^ ur tjyiea 
b ana reasori. AnoJhsr fsamn Is ttiat csflain nelcls. ar* Idfaar 
ttwn Bre*&ntiv nasdsd In anHclpoflwi q1 th^ j«qulremen1a of 
fuTu'e gijwl Hie sysfama. For example, the ftoDOS 14 create 
■cad's paramater block fcKrydos a a-byta ayn^ty-pe flald, even 
though, on dtek, the auj:_^typa llald ii only 2 bytes v4de {a^e 
"Formoi and DroahiiaNDn o[ DfrBclay fiiaa" if^ Appendk AJ 
the Iwo N^wwaer bytai In fhe md mii*t JhiwefofB olway* be 
ista. 

liorigBi Qj permia^iB wjrum for all paraffv&f era ce^ givan oa part 
Ql the sysiern caU desqrlpttora Iri me rodowmo tlvipt^n When 
oadlnp a parnnwfer block, note caraTglty Its rano& or 
MfmfcHltle raliras for ftoch parometef, -end make sure that tha 
VQ\u» you Qsalgn is wfttiln ttnoi ranQB. 



Setting up o poramstftf block In mamorv 

Eif-h ProDOS 1 S ail uses a A-byic polnier [c. polni to iw paiaincEer 
block, which may be artj^fcrbcrc in memoiy. A3| applicaUatis musE 
obUin nceclEd mcm.oiy from ihe Memory Manaj^. and [hejEfarc 
onuQi htKm' in jd^-ant* where the jitmoiY Hock holdlne inch a 
inracneter blodt wjU be. 

Tlicfe ace two wjjis fci set up a ProlXM. 1^ pafsmcto block In 

J. Code [he bloeJi dJicdJy [nra [he pingram. refcrwdng ir with a 
label. Thii is rhc simplest ajid rrn>si lypEca] way ca db it. The 
paninFEcr block -nolJ ihvayj: be correal}' lefFrcnMd, no mitter 
where bi menmry the pmgim) code la In^^^d 



Ctiaptor fl: MaKInQ Pn5[>M 16 coIIb 



! . Use Memory Manaecc »nd Sysi^m Leadw alls lo place iJie Mcjck 
uiffletnory: 

a. Be4iuest a menwjry btmJt of the prapcr aiiK fmm ibe hiemocf 
MitA^t Use ihe proccdujcs deac^iibed Jn /Ijipie Wgj 
TtiiOJ'tefls aeferemx. The binds shoOd be eUhcr >tft3,4 or 

t>. Obiain i point? ta the blode, by deceferewcmB the lueroorr 
harKfle reluincd by One Memory Managci (ihai is, i«ad ihc 
mnAcnu di the iacitioti pointed to by ihc harwlle, and UM tM 
vahie as a poLnicr iC' iJie bltick)- 

c. Set np yciLjc paiairtctv hlock, starting at the address paimed lo 
b^ the pointer obtained in Kep (bj- 



Register values 

"[here are no legLatcr Teqiila^menia on *Jiiry to a Pjt>DOS 16 call. 

?ioiM15 1-6 aaves and icworta* all reflHCc^s caoept ilie acajmulator 

W and the praccssoc suiui MaLsicr CP). those Iwd icgiscers stmr 

IjifpnnatiDn on the success or fajJuTe of vhc ciU. On exii, ihc 

tcgtswrs hav? thtoc values: 

A jerolfcalisucorashjl. Ifimmcra, nuttiber ijthc effoiwdi 

X unchamBKl 

Y ui^chan^ed 

S unchanged 

D iinch-angcd 

P tscc bclo*^') 

DB urLctiariijcti 

PB unctianged 

PC ictclfESS of iDcatioti folli^wiRfi the piiameter Wodt poinor 

■■Unchaimcd'' means tint ProDOS Iti inJLlalty savea, and then 
restores when Tinlshed, the vabe ihe reBlsU;i" t^ad just before [he JS 
PRODOS ansinicUen. 
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part ll: PtcDOS 16 System Call Reteienc« 



On eiJi, itie proonsQr snus icgl^ter C^Z bHa are 

undcSaciJ 

LJtidian^d 
uni;hartged 

2 uiuleflned 

c zew if call sUCtMSSfuU ] If no[ 

♦ AWf: Pio1X>S Ifi iTMls several najss d.(Ie(eioiJy ihan froDOS A 
The n ind i fogs are ujufefiflcd here, under PtoDOS S, [hfiy arc 
scl atcnrrfing to the value dn ilw actum til a lor. Here the caLEcf 
may check Ihe e flag In see [f an error hl& occurred^ ufldct 
PfoDOS 8, boih the c and T fligs dacnninc error sunu. 



Compprlson wHh th& ProDOS a caff mefhod 

Witfi ihe MOiptions n«ed in Cliapwi I, PinDOS ]6 p™.ld*a an 
iderijcal all for each PraDOS 6 system call The ProDOS 15 call 
fKrfOfras eiaca}- the stn^ JurvcUwi M tla ProDOS S mpjJvalent, but 
ll Is in a Ibrmal tli:(( flis the Apple ncs envijoriBnent- 

13 As Jn CrolXJS S, ihc s)-slcm ciU is issyeJ thrtjujjji a SubfrntMc 
lump Id a flxed syslcm enuy poLni, | luwewif, ihe pump 
Inanition is a jgj. jathcr than a JSr, anri ii is m a hjcaaun u, 
banh SEl, rathe* than bsLolf 400. 

D the paumeiei block pavmst in the system call is <( )>>ne5 [fin^ 
father than Z^saOje pjrainctcc blodt can be any^-hwe m 

mctnory 

n All memory polnrer fields -..■iitUji the paiuneier block arc aE90 4 
byics bng. so ihey can rtfcrcn« data anywhere in memoiy. 

a AB l-biflcpvaiiMicrsafee^iendedio 1 wnrcHm icnRih, for 
efficient maniiniilation in Jfi-bn processor modq, 

D Alt flle.posirinn (such is EOR and hJoek-spedfi cation Csudi la 
block mimbcr ar WwA counE) Jldds m the piiamctej btijck are 4 
bifliea Iqub, Jn artddpaiiori uF futuie gutst JHt systems that rruy 
suppnn nies Eargef than l6 Mb im ralumM. larj^ iMn 52 Wb 
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ChQptet B- Making ProDos 14 calls 
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4 jvws' Although ditif i bytes "c redded Fnr menojy poini=r» 
and blKl. number in *c Appte TIGS, **yte po^r* 3.e i^sed 
fnr eise of pros™nm»"E TTic high-order bjrte 11 «ch .dsa u 
leseivcd and muK be kio. 



The ProDOS I* Exofclsor 

I'a help fm Irarti lo make ProDOS 16 calls, there ^ a JwU 
DTuaram called ihe ftcD05 /d Eterctf^, Ofi a disk liuiuded with 
dm manual li jllo«s yoo lo CKeaite syii™ calls from a mciw. ^ 
examine tN «:=^Jlw nf yo^r ealb. il has a he.radef Ima] mern^ry 
«tilM for rcviewljis «.id alterii^ the co^te^ti oT mriflorT biirtMS, 
ind it includes a ratalog command. 

when you use die Ertrc^rerio rtukc a PmDOS 16 nil, vou fira 
requcsl Ihft caiL bv lis tall number »tvd thch specify 1« paraCrtEiw 
Usi iLtSt as if you wet« coding ih* call i^ a pragnra- TTw cdl tS 
Mtetu^d Whoi ytlL. J«S& Return. Yo« rn±y then use the memory 
editor or catalog command to N^^amihe the rcsulL, of ynLi. call 

In^tfUOJons for uaiflS l^-^ PK'DOS 1* EnWUpr piUS**™ ar« Ln 

A.ppendjUf C, 



Foimcrf lor system call clescriptions 

The lolltwiKS Five chapien;. llsl and des^Lhc aU Pffi.DOS 1^ 
opEdtinB svstaJn furKtlons iMl miy tw oiled by art jppUado^ 

i:i<h dcSfTiption iftcludca these etenifinisi 

□ ihe function's name and call number 
Q B short ctplanation of Ik use 

□ a diasniri of its lequited pj,ramcl«1 block 

ti. t detailed dcKtipfinn t^r ?1] paiamacra in die pirameter bloc* 

D a llE[ of ill posslWe opcratinB syiitem errof mcs.5age5, 

-me paranMiet blodt diEsfam ictompanyinfi cicti aM's 
desaiptio^ is a simplified rcpicsertalion or [he pjr^rrKter blo^ * 
mernory THe width of the diaBram rtprescnis one bvie; the 
numbeia (bwn Ute idh side reprcsem byte oilscis from the b*.« 
atldrWB nf itbe parametei block. F-ach pwanjelrr Teld u> Furfier 
tdentified M cacilairtlnB a vsliw, rcsull, or palltfCE. 
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The deunc-i (KLnrnder destripUgri ihjt tnlicnis ihe diMrsm his the 
V om^ The pasitiaa of nJw pinmcier Crelativc to iht Mgdc's 

■ labeL The ^g^eited assefflbly-iingijasc iaixl (ot ihe picamf tcr 

■ DescHptlnni neratlcd JnfomiMi™ on the parameter, 
inclLding: 

parwnfier aanxt The fM fame of the paiameler. 
bIk and cypt The si^t nf ihe parantciet Cwnwd or lortg worij, 
and iis diMJitsu-on [^s]ije. iceuIi, ur poJnier?. A wgrnU U 2 byrcs; 
a long ".njid is ^ JjVIfil. 

range of values, Tlie pcrnitssi'bte ranae or values of :hc 
p^amcEfir ^ pinmcier may have a range much smaller dun acs 
Size in by^iEs. 

Any iddJiionii explanainry inronnaiion on [he pariuneic!- 
raDcm^.. 



Cr^apirar S; MoWfig ProCBi 1ft ec*j 
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Chapter 9 



File Housekeeping Calls 



IW 



These alls migM il»0 be «lled "clD^cd-TJc'" calls, itiey Ife made 
\a gei ackd aa tnfonnati'jn aboui files dui iieed rvm be open when 
ttK calls arc ms.dc. They do not alter the comehU af ihe TJes iJwv 

Tlie ProPCB 16 flic housekeeping calls are described in ihis anleri 



NiimtHr 


FuncUgn 


hapci* 


301 


CM ATE 


ocalcs a new Rlc 


S02 


DESTROY 


deletes 3 Ttle 


JW 


change: paxk 


Ch£[1ge! a r]e'3 [Mthmame 


505 


Set fil£ IMPO 


assigns aurfxitcs to a file 


iQ6 


Get FILE IMFO 


renjrrts 3 file's lUnLiuteii 


SOS 


yOLUHE 


returns the vcilLirne uii 1 (J^wifC 


i09 


SBT FRSFIX 


a^sl^ns 3i pacluumc prefix 


iOA 


GET EStKFIK 


n^lurn^ -9- piiJunajxLc prcGji 


£0£9 


CtEWl aUCEUP BIT 


zeroes 3. file's backup Allribu^ 



I 



1 10 Port Ik PtoDOS 16 Swtwn Call Itefersfca 



Paramaler dabcrlpflm 



air 1*1 



lt±ml 



5QO~i03 



j^attinajrw 



aZEATC <$01) 



Every dijk Ule Cxacpt ^ vtAume dircowy Tile fend any Apple D 
Pi^CiU region on a panJUcred dWil musJ be rreated wUh LhLa caU, It 
esiibtishcs 1 new dircccniy ftmry for an. empcy rJt. 





1 

2 
5 


i:>athnarrM| 


- 


poinrfiT 




QCCBiH 


- 


jfilya 


& 

7 


fite.tvpe 


- 


vaiLiB 


& 

t> 

A 
B 


□ UK.typO 


- 


vaiuB 


(J 


5l"orafl$ "Ivpe 


- 


uokjs 


F 


Creole. date 


- 


vaij? 


lU 

11 


cr»ots_rima 


- 


value 


CREATE [JOlf 

Pljramatier block 







PtKrtiilliBn 



size BciJ 1>pr: 
nuige of Ta]|K8; 



paitinamc 

tor(E Wffld pointer SiigJliJEdei byte Mfo) 

JSOOOO OOOO-SOOFK FITF 



The bns word 4<klre5a af a buffer. The bufTer canEaiivi .a fcnsth byte 
foUawcd by' an ASOI String repfesentiiift the paOuaniE af ttte fQe lo 
■create. 



ChopTw 9^ FJIo Houselt&epina Colt 



I]] 



ParQm*1*r dBscrtpHon (conllnuod) 



onttt 



uibil 



DaacilplllDri 



SDpI-KS 



306-S07 



flls ^yps 



${]B-$[i'a 



aui!_typ& 



word v»lm; (high-onlcf byie lero) 



7 


6 


5 


a [l |2 


1 





i) i^N 


B 


rtnrw^ 


M 


n 



^Lzr and 1)^*^ 

A word wticisc louj-ordet b^tc dclcmnn^i hCTw the fila may be 
accMtftd. The acce&i byie's fcumal ia 



VtfW. 



•whcTC D - d&stEU^'-cnablc bit 

RN = raiumfi-enibJa bit 
B ■ bad(Mp-(JiMiJcd- bit 
Mf - wtiCE-cnable bii 
R - icid-^nable: bli 

amJ foT each bit, : - e-nibled, - dtgabfcd. Bits 2 thraufili 4 are 
ttseiveti and muai ilwaj'i be sci lo iwt'Ci Cdtfablcdi Hw: raosi lypidJ 
ftetttrtfi, Fftf the acccK byie i.s SC3 (3 tflOOOll). 



watd value fhigh-Ofder byte Mfo] 



jeIic and typ^: 
njige of ^'itlues^ 

A numbci thit ci.lcsofim ihe file by ila eMIieiWS Csuch as lenl (JICl 
binarr fUe. PraDOS ]6 appJicaUon]- Currrnrllv Jefincd me Lypo | 
ate Msied in AppeotJn A- 



pifajiifTef namei 
rani^ of ¥l]ue§: 



aiinEUi^ Lype 

long wnrd value OugSl-tXifcc ward iCfOj 

Snooo OOOO-JftXlO FFFF 



\ number ihjl Mdlcites pddiannal a[[fiburC5 for ccitajrt file types, 
liximple Liacs of iJic auidliaiy lype Held if.c Bivrn ifl Appcsndls A 



11£ 



PnrHI- Pf*D05 14 Svstem Coll Rsf^renca 



^urainvlar dctcrlpllwi (e^niinuacfj 



on 1*1 

SOC-JOD 



LntMl 



&«KNpllarl. 



atora5e_cypB 



JCE-JOF 



'Create datei 



flip aJld type: wuptl viLuE/jcsulI <Jilgh-C«ler byte otitj) 

ranac cif ualuM: SOWU-SMOD wllh CBCEptions 

A nLunbcE il»i desoribca qhc logical crganiauon cf jhe file (j« 
Appendix; K> 

iOO ' tnaolve entry 

501 - needling /op 

502 = MpUra file 
S(li - tree fib 

504 - Apple If Faso] icginn on i pantuoned disK 
son " dircaofy fll^ 

501 piiid JOD an: Uic nifWE Ij^ncal Input ^-aDues fe ihii field in the 
CPEAte call; jfiy value in Ihc range S(K) thiuugh JflJ is 
aWCimaiiCally canBcrwd DO itl inpui (and oulpuO uf 501. 

♦ .Vate: SOI: and SOF are noi vulid storage types; they iir 
iUlKliTCetaij' and vijlume key blodt kteflcili^^. 



pdraoieter iMinet 
»Jj«aiid type: 
™i)(? of vilun: 



cresijort dale 
wnrd. vakie 
llrtiiled range 

Tilt date on which the Die wa otucrf. Its foimat is 








Bi»e 1 








iVOD 




15|I4 13 


1? 11 10 7 


llL 


« 


6 


'ilaj: 1 


■Q 


Veor 


Month 


Dqv 



II [he v^ltje tn ihiB Reld is aefo, PmOos ifi suffilEcs ihe date 

obtained Tiam the ayauiu deck. 
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farama\»r dVtcHpHpii (eonilnUWd) 



Dlfl'1 



UbH 



JlO-4]] 



c;r««c« tiLiiis 



I 



iMicnpiian 



pAf^ratifr naitie: creaUan lime 
size aad lyp*i word Wlue 

I'uvge of valine: Limited ranBC 

The ume it mhidi ih* lite wis dr9,[t:d. 3is formal is 











Bv^s 1 












ByieD 




* 


15 


M 


]3J12[21 


IC 


^la 


7 


6 


5 


i 


^ 


2| 1 |0 


ViA>B. 





C 





Hour 








Minute 



polhnoms 



- pointer 



"tf ihe vfttue in itus fleJd te ^ouo, PiotMS 1^ supptLca Otg ftme 
Dlnuitied from the system dodt. 



Ponlbia h^DOS 16 ofioti 

S07 l^roDOS L^ busy 

J10 Device rinl [aand 

327 IVO eiTDt 

J2B Diali wflK-prfflccicd 

%4b Invalid paiJii^rtie EyntiK 

S^5 Vcilumc not fourd 

M6 T-ilc no: found 

$47 DupLicitc piT-rtname 

■i-ts Volume fuJ] 

S45 Vnltimc dirccicrv ThU 

S*a unsupponied storage [n?e 

J52 Unsupported iMlujiie type 

$5J Invalid p^.l^meur 

iifl Not a Wodi dcvinc 

SSA Block nuntose out nf range 



IM 



Part II. PfcDOS Ifi Syatem Call ReferHnta 



OESTROY ($02) 



P^rani*t«r dtttcrlptl^fn 



labal 



S0Q-S03 



pjtthnajre 



DESTROY C$02> 

TJii-i fufictipn dclsTcs lUe file jpecifed by paLhuamt. Ji icmovc* the 
fiCe'i eritry riDm the diicctairy OaX owns it and ijctuni:; [he File's 
btocka ta the itjlume bit map. 

Vdujne dlredory TileSi if^Ies v^th jn/ecogeiLsed stDrige lypcft Cother 
than lOl, SOZ, SOi, or JODX and npen files oannoi be daatroyed. 
Subdireaoty Gits rtmai be emply bettor they can be destn^yed 

* ,\'Oie Wlien. l lik if desijoycdr iny LihIck bOodts iL cojiUins are 
ini'crlcd — that ii^, the fliil half pE the b!otk SJld ihe KCQUd llllf 
stvap pDsiiicinB. That levE-rsciS ihe oider of the hpiE& in aJ] 
poimcPS Uie bloch ean,Hln3 Dijk scavenging programs can use 
this I riri3CTTlslJGn [□ help recnvrr icctdenlaLly deleted files. Sep 
AppctHftx A (ot a desciiption of Index blcfk sirutriuw:. 



Daicrlptlan 



parametrr namet 
«ii« and [jpe, 

raCKC 4!f VaiUES: 



paiJmsme 

Long, word painter Q\i^-Dt6it byi£ Krci) 

SCfiOO 00CO-SCfll'>- Wt'f 



The kjn£ wtmJ address nf a bufliei. The bafltt oonrauM a length byic 
rrvllnwed by an ASCn fflrina icprcpcntlng the paduwme orthe file » 
delele. 
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Pouible ProDO& 16 enors 

iaj PraDO* Is fa^sy 

SlO Ei^vdcc rtai faund 

S2B Disk wrltp-pcclccKd 

S^O Invalid palHiTdflvc synLM 

i4^ Pilh not frund 

tft Vijlujnc not fOudd 

J4£ Fitc nuL round 

J^A Vtr«iO(i cryai 

i^B Unfuppcmed storage type 

i^l^ Attcid: rile nfit dcstimy-eiublied 

iSO file is cpe«i 

j'52 llnsupponed volume lype 

S5S Wo[ 3 block (fciicc 

S^A Block number ouinEnnae 



1IA 



Parr II: ProDOS Ifi Sv»t-ern Call Rsterenc* 



A 



CHAN&E„PATH {$04> 

TliL:; riinrU'Dn periVms an lumrVDluine flic move. It mtriFea t tie's 
dlieowv -efiuv ffom one subdlreaory im anenhtr wiihin ihe aame 
vdlunnic tlhc file itself Li never moved). ThE specified pjthn^nie arid 
TKW pnhmaiie: may be cither Full nr psfliil palhnamcs in ihe same 
vaturrsc. Sec Chiplcr Jl r<vr )(i enplifistlon 1^ pjftlj] path-rvames.. 

To rename a vnlwrns, the specUied pathname and new padinime 

must be vulume- namEs onty. 

If iha cwM pathnames ste idcnliral dCEpT for ttip rigjilmnst fflp nim^ 
(ihit is, rfiwCi iJic old srKi lew narewa are in the same 
subducclDiy), this 4:al] prmjiu:^ th« »»a>e reauh as ithe iR^KAHS call 

in PmDOS 8. 



EefRfS;^ - Bof\[P 



' rpew.potlviQm* - polnl'^ 



CHAUGE.PATH (.SOii 

* jVoJe. In inlilal releases d{ PraDOS I6, CHANGE_PATH \s 
iWEnaed lo b, fJenamc chinjtc cifily— ihii is, ii is Funetiofiilly 
idemjca! 10 [he BEHAWE call in PiolXDS 8. 



ChaplM V-. Ffe hfdti&ekeeplnB Cdlli 
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Parom>t>r dvi^rlpllor 



Dirt*t 



Labd 



iDneihrtfon 



tM-$Q3 



pfctbnwnA 



SO-MO? 



fi e w__p a t hnome 



iang ■word pplnicc (high-isfdec byte 3cra> 
iOOOO OOOO-JWtT FFFF 



panraeier namti 
hIz£ and tjipCi 

The Ions ■*t^"1 sddrSM. of a btifTcr. Itie buffer conEitna a Un^gfh byic 
(aliowrd by In ASCli stiin^ icprtrftmins the Hfc's present 



parameter nitmee 
!iiw and lypc: 

CjlAfl? Kjf values: 



new pithiianw 

long ^OTd cwititD dugh-OKter byte irraj 

OOCO {XKX)-JOflFF fFFF 



The long ™«"d address oF ^ Tuiffej. the bufitt awmtains a !«ig[h bvie 
toUowcd by in ASCII sLrinfl rcptesenLiryg ttw TGe's new paduiAmc- 



P(H8lblB Pn^lOS H MTcm 


so? 


PrnDDS Is busy 


S37 


I/O error 


$ZB 


DdSik wriEc-prowcced 


140 


[niMlid piihnanH syntax 


«1 


Paih lior found 


545 


Volume ^ot fouiul 


S46 


FJlc HDL liKtid 


S47 


pupLlc:atG palhiujtte 


S'tA 


Vera inn tciOT 


J^B 


Unsupported sinrase type 


HK 


Access: file rtot ren*me-cn,ab!ed 


S50 


File is opefi 


S52 


linnjppQrtcd volume type 


*57 


CkjpLiate ifolumc 


JM 


Nol a block dcvi« 



lU 



Pari II: ProOOS 16 S-vatam Call R»rBrerG& 



SET_F[LEJNFO (505) 

This Tuncflinn modifies the InromULion Eil ihe ^jedficd file's 
dirrdcwy entry. Tilt call tan be made whether [Jie (lie Is Open OT 
■dosed', hOTrevct, my chanjted t-S'XSf aHfJb^Jles arc not jecojjnJzeil 
by an open iile UTiidl iJm .ricM lime ihc Jllc L? npcne<3. Ijl iMhet wtw^, 
Ihls call does not modifv Jie acce-MibilJiy uf mem oiy- resident 
infnr[n.2Lic]n. 

+ ^tpfe Ciiwcm venioiu at ProIX)5 16 igrofc input vil|j*3 In ih* 
cee-a.tA date aiid nreate ti-me field* of chis EtincriDn. 





1 

2 
1 


■ ' pothrvrr* 


Mifrf< 


4 
5 


•- access 


v^Lie- 


7 


nie.fyos 


ViUJUB- 


a 
p 


aij^-ype 


valLjs 


D 


tnulfiBld) 


valuB 


E 


CBatB-.ocire 


value 


11 


crBalaJIme 


vol 119 


19 

13 


rrtOa.OaiB 


valuB 


14 

15 


" m^a Mtip 


NnajB 



5EI_fl[.E_IMFO itOS) 

faroBDeitw block 
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F 



Paramat*r OaurfpiiDn 



ciri«r 



LflbM 



DaicjIptlHi 



*[K]-SOi 



S04-iO5 



pachnaErs 



SUS-i07 



Cil-B_type 



joa-iOB 



au»_r.</pv 



paramcler nam's; pathname 

s.i'j^ and iyp«: bng word. polrdcT (tif^'Ot^sf b^ xeco) 

rani^ Df -valucst iMW OOOO-SODfF FJtT 

The lung word address of i bLLfTer ITie bulTer «tmaffi* a tengih byt 
Followed by an Ascc sirmj rppirscntii^ the Biei pathmme. 



parannler name: 
sikH xriJ lyiic: 



7 


* 


5 


4|3 


" 


1 


□ 


D 


3N 


e 


rs-ierved^ 


W 


f? 



S0y00-lOOE3 wiih ciccpdans 

A word whose Low-ijrtler byT= (klcTminca how ihc file may be 
aWKSaed. Th* access bylE's formal i* 



vau& 



where D - ■d#sirtjv-«rab]e bil 

ItN - jEfia me -enable bit 
B ■■ bacltiip-nccdcd bit 
w ■ wTitt-cfiabi'; bii 
H ■ n^d-cnahlc: hdt 

and far each bll, 1 - enabled, = disihted- BJtS J CKrough 4 IK 
macirv^d and must ilway? b« sel 10 Mru f disabtcdJ. Tlie masl lyplcaJ 
jeicins for the atir<!ss LiyTc ts iCS £l lOOOOt 1>. 



param^ier lumci 
raDRe of valae«i 



file type 

HOrd value Oiif^h-grd^ byte 2er<4 



A ninmber thai Citaajoes ihe fd^ hy ils ■CWllt'ElU <5uch ai Hmi f[lc, 
binary flic, ProDOS l6 appHicaucnJ. Cur/cmly dcFifwd file [yptf-s 
arg [uced in AppcjuUx A. 

pxramcler iiam«i au3ti!iai>- tj'pe 

slie and [ype: !o(^g woid value Chiah-order ivord MroJ 

rDnxc ofvaJuHi Jmoo OOOO-MOOO FHT 

A numbei [hl[ irtdicalcs addiikmal allribmce-s for ccruiEn fLte cypii 
EKiKipIc uses cif ihe auitiliiMV type TiClJ lit gi"^" ■" AppendiK A. 



32a 



Part 11: PtqDCS M Syi'tam Call Retersnce 



1 



PwQiTwIer d (Clip t Ian (ceM Inuod) 



□ rilal 



tpl»l 



D«H:rlpllar| 



SdC-SUD 



SOE-50 F 



Inull field) 



Qr0«ce date 



SJD-S1I 



cieate tine 



$17-SI3 



mad dAtp 



I 



parameter nflue: 
$i^ add li>7fci 



BvJ« 1 






Bv^eD 


15jl4 I3|1? 


ft 


10i9 


B 7|a|sHUf2| 1 loi 


Veor 


Menfh 


Ddv I 



wonJ value 

(u ndcfLn-ed) 

VaJue? In [his RcU irg ignored. 

parBmetf najDB cremjuii date 
sire andl type; vmrd vatue 

nUt^F ol iniJuest Lmlred range 

The dau: On which die fUr wk aeared. Iia fcwmit is 



Vgnto. 



(Values in thij field are igjiored) 

pantatltr iiain«; cnratinn linw 
ilie Bad Cjrpc] wi>itI vikie 

rang* of vaJimi Jinslicd tangt 

The lime ti which the Jjfc wsw created, hs fomat !s 



wyyff.- 



O-'alues in ihiB field aie ignorcij.) 

pardmurter namei modilicaann lijte 
alic and lypci -wcrd va]L>e 

fARKC Elf values.' llffliLerl range 

The dale on which thn; Jlfc was last modLTcd. Ila Jbniut is Idcntica] 
to the create dace forniaL 



Bft 



IT the vatue in this field is wro, ProDOS l6supplEc5 Oic daie 
oblained {torn the sysKnl dock. 







Bj- 


s1 












Byiaa 






15 


14 


I3M? Tl 


IQ 


' 


* 


7 


6. 


5 «9 


3 1:^ 


T 


c 


D 


Hovr 


D 


□ 


MInulo 





Bvra 1 








it^B'D 




|1&|T<]|13 12 )1|I0 


9 


S\7\& 


B 


^ 


31211 


|Q 


1 Veot' 


Monlh Cuy 
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f 



pLiarrwIvr dmcriptltin' (CUllhUMJJ 



JHJ-5 3 5 



nuya time 



QiKrtpltan 







BytBl 






fr^sD 




15 


14 


i3[i?|n|io|=?|a 


7 


4 


a 1 4 1 3 ; 2 1 1 


|D 


Q 


D 


1 Hour 








Minute 



slie and type? wcwd vahic 

rangir of raJutS: 1iEnt[c(L tinge 

The lime a[ which ihe fele was Saw moddfled Ies famiM is idHUicaL lo 
the C£4«te time fbfm»L 



ST' 
VaUe. 



IT [he viluc in [hla Held is xera, FroEX^ i£ sufrpUea it£ time 



Ponnjle PtoDOS 1* errorj 

JZ7 I/O cmjj- 

$3B Disk write "pfolecwd 

i4C InviUd. pattininic synux 

S'1'4 Path ncit fiini^nd 

545 Volume noc found, 

546 FJlc n[:it found 
S4A Verstrin errni 

94& UruuppuilHl ilursge type 

3'4E Af:f:ea!: die not wrJlf -erica b(^ 

552 UrMupponed vol^jme type 

$^3 Invalid piramdcr 

S5$ Mot a Uock device 



1^ 



Pari tl^ PmDOS 1d Syitwn Call Refsrenca 



GET.FILE^INFO <$06) 

"tills Function ECtums Ihe intntnmion I^ai us stated in the spcdflcd 

ELc's dLTcOfify cnnry. ITie call car bt midc ^'hcth^tr ttw Jlle Is o(jmi 
nr dosed. Hctwcvct, if you mike the 3E7_F1LE INFO caU ta 
chinjic the 1C0C5S byw of in open file-, ihic access informsLior 
feiumcd by GET_FTLE_rHFO may not be aCunaU: until the file Is 
clgi^d. 



Q 

1 
2 


POt'inOrfMl 


Mini 


* 
•^ 


□r^f^ei! 


•Shjir 


6 

1 


rile_tyce 


m&jlr 


A. 

H 


□ux.lype 
cr 

tQIQLDIDC-la 


t»ijf 


n 


sio'aae.lypa 


r^lUI 


r 


crealB.dats 


rejut 


10 

11 


CT&ai-B.i'me 


reiuit 


13 

n 


fTiod_cln^e 


ruLA 


1-1 


rnod_time 


rsiut 


16 

1? 
19 


DiOOlii.used 


raiuir 


SET_FIL£_INfO fSM] 

Pawmetei tilcvck 





Choptw Vt FM htQUMko«p^ Calls 



123 



P^ranwlar dMcrlpllon 



EolMl 



soo-ios 



SQ4-iOS 



pettvnamft 



S06-407 



fil3_typa 



DtKrlpMan 



ilir and typ«; long w^nrd pointEJ- Cbu^l-OHte' 'jy^E' icro) 

faitgc Of vfllucat StBOOflOOOSOOFFFFFF 

-[■hi; long ward addrca* oT a buJTef. Itkc buffer ccntains 3 leniiUi byte 
ftilQwed by m ASCII etnng irprrscming the pathfiamc. 



parameter Rwnei 
■liE andtypet 
range or values [ 



access 

!00(X)-iOi>E3 wiih excep^ltjns 



7U 


[51 


4 |3 


[^ 


1 


Q 


□ WJ 


B 


respru'sQ 


W 


n 



\ wurii "(hcise low-ofrter byre dcicnmnies how [he file may be 
aec»Kd. Ths v^^^ess iiytc's fcinnal. U 






■arintt D - fl'^ If oy -enable bil 

RN = jcjunie-e aabt« bit 
B - b^-ckup-nicedcd bi[ 
W = wriit-enable bit 
K ' rti&d-en>,ble bii 

and far each biu 1 - etiabtitl, - daabled. UCle 2 through < aic 
icRcrvcd and mus-t always be Set to irero (disabled!. The iin;6t [ypiciJ 
xrning kv Ibe tccib^ byle is JCJ CllOtKHll). 



PnrnmBi«[ dMCflplloti <conlinu«d> 



QTriti 



LaM 



paicilpllon 



SOS-Sob 



[jlc iypc 
SOMO-SOOFF 



piiraiUi^lQr name: 
s.lze acil typ<; 
rang,c orvalucsc 

A numhcr that citeaDriies tht fUe by ils contcnK llsudi as [Ext file, 
binary file, P.uUOS IS JppliMtiorO. CuirerUy tlelineiJ Fil* rypcs 
ilK UWd In A.ppcnd]T A. 



I2d 
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SOC-JOD 



auji:_tvp« 






a t o E a ge_T:yp e 



ME-SOF 



CEea.te date 



paruneier nanif; JUAtllary type 

size and type-. lang word resuh Chigh-Drder word 2£M)) 

ranic of nlaes: MOCO OOOO-SCKMO FFFP 

\ number liuL in<licaTes addition^ ELUnbuLBS for csruLn nic typca. 
Example uses cf ttt? luxihary lypc (Held are given in Appendix A. 



porajncivr nwmei tool blocks 

slxc and type: long w^Jrd resLjIt Chigh-cudei' byte 2«oJ 

range fil t^UCS: ttWOO QOOO-JOOFF FFTP 

]f tbe ciB to for » vohimc dtroiieiiy Tilie, ihe [otaJ number of blodt» 
□n ihc volume Li ft lutfied In itita fteld 

pafameier narae: Kongfi rype 

slic and typci woid reauti (hJgh'Otder bylp icitO 

r^nge i>rva]ue« JiWOO-SOCOD with cK^pcioiu 

A njiTibei lim dcM^nbcs the loficaJ oi^ntESttcn of die lOc (^tt: 
Appendix A): 

SOD - JnatUve enuy 
SOI " £et^dljrlg HEe 
SOJ - ispling nic 
303 "irec ^te 

301 - UCSD PMcai icglcn. on a panlUaned dlslt 
5oD - director^ file 

* N^tf- SOP- and SOP "i^ nat valid al'fir^ge ivpes; itiey u^ 
subdJicctoiy d,niJ vOluiiK key block idenUflcns. 

parooifier nssie; creailon daic 
sl2c and iTpei ward rcsulL 

ranjic ofvaluESt LLrniied range 

The daU! on which ihc file Trt* Crtaied, [L3 format is 



ST: 
ValDS. 





B\',S \ 




ByteO 


IS 


iail3|12|ll|lD 


93a| 7|fi|S 


4ia 2 1 


Vaor 1 Month 


Day 



<9kt''^>' ^ >^ii» HousMSAping Cau 
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?oramBl>r dstcdpiiort (cantkitwdt 



Slfi-il? 



bloclts iti«d 



Dt<i*1 



UMt 



DVIBlMton 



tlO-ill 



;Ei*it*_tiina paramwer muaci ciCillon lime 
sJic artd rypci wtwd icmlc 

ruip of Tilusi UmiEed nngc 

The time It wWc-h the file ■wm created. Eh fonrut » 



9i^ 



J12-S]iJ 



nod d.at« 



Sl4-Sli 



mafl time 





Hvlo 1 


E.vfffO 






15 M 


13|12|ll|1Q'i9 


B 7 6[s]^ a 2 


1 





VeQr 


MOrtth Day 



parameter aAitlC; madiSicalifi^ date 
sl2c and ryp" '^^ '^S"" 

nn^ of iralutfc Umllcd range 

The dale wn whith Ihc (ile *« last mcxlifcil It» ftmrnBi is tdcntial 
lei [he cteace dato- fornvai; 



fOTL*: r 



Byle 1 


ByicQ 




13|U 13 12 11|10 9 


8|7|6 5|i 3 ?jl 


12J 


Voor 


Month Dav 1 



psramrlft mmt) modlficjvltin lime 
alit and typn wnrd ccsull 

iBuRC t>f i'3l\ic<] Licniiod range 

The lime ai wludi the ftl* wh la»i rrtftdifled. Its formi e idcMicil |o 
[he crtate_timw fgmiaL | 









B>1*1 








Wf^ 








a- 


IS lil 


lahs 


" 


10 


9\$\7 


6|5 


a 


3. 


2 


1 


Ll 


VOkta. 





a 


riour □ 


1 MiTJte 1 
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Part II; PtoDOS 1* Sv^latn Call ItaterencB 



paramcHr namci 
aiu uid [ypct 
toDft of vahitu 



bktduusrd 
Inrif word K3v][ 
JOOOO ODOO-JFFFP FFfp 



Tlic tc43l number of bLotlcs wed by ihe file li eqtiab ihc vatue of the 
blocka_kia«4 paramcLer in ilw file's dm*«ary cn&y- 



The loul mimbcf of Wocks used Iji^ jJt life* on ihc vqIuiw (if iht call 
is tot i vetuinc diredory). 



Possible PioDOS 1 6 eiTon 


$07 

$27 


ProDOS Is busy 
I/O crmr 




Invalid pathrume lyncax 
l^ath nn found 


S4S 


Vnlume rwr found 


S4£ 


yOc. not fcund 


Ufi 


VenJon CiTur 


S55 


Unsupporred s(c>n|fe lyjx 
Unsuppcncd vnlumc type 


J5I1 


pJa[ 1 block [tevidc 



Choprw 9: n» Houwkeeplna Col* 
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D 


_ 




_ 




1 
t 


- 


dw.roma 


- 


P<jHt( 


I 


- 




~ 




■i 


_ 




_ 




b 


- 


voLnnmB' 


- 


DOnt 


J 


- 




- 




ft 


_ 


lotal.blQcin 


_ 


[bujH' 


B 


■ 




■ 




c 


_ 




_ 






- 


rr^o.&icck) 


- 


rau^n' 


F 


- 




- 




10 
11 


- 


tl1*,i¥l.W 


- 


ICUjII 




ILUMI (SOU 







VOLUME <$Dffi 

when ffvfn [he ciame oF a. dtvJffl, this functiDn jciunis: 

D the J'OUl number of blocis nn the volume 

D ihe cunen! number of Ttee (unaHctcwed) binci« on the va\iua: 

n ihe Ok (ysttm LtknUrrfauicin numbef at the- valumc 

Tu ^nciaic a lal of iJ maunlcil vol jnic» (cquivs Icrit lO <7U1<^S 
&N_L:tiE In ProDOS fi ^ith a unii numbec nf mm}, till VOLUME 
rcpeitcdly with juccc^Lvo device ri^mcs (.Dl, .d2, ard fo on)- 
■Wticft Ll)ciT arc no mere online volumes lO nafllC, P(oDOS 16 
returns error SU Clnvalld device icqucst}, 

♦ AiSte In ccrtstrn caws iSir ciampt, whtfii pDllifig Disk [1 drivral 
PnijDOS 16 canntH Jctca the iJiffeTeno^ between an cmpL> 
dcviire and i noneKislcnl ijcvitc ll msy thMernic aisign a 
(UfvJcc i^ime where ■Lhet* is iO (le^'Jctt connccScd, jii5l to make 
sure it tiisnl skipped over ixi cmply ■ilcvlcc. Beciuie Of this, in 
mafting VOLUME catls, you may occ as ion ally Krd that tlicrc are 
man: "va.Ljd." device nsui\cs than there arc dc^'Jcr,;; ai\ \ine 



PdrameFai dsicrlpNon 



CDllVt 



iQbfll 



[nicripiMn 



S0O-S03 



S01-S07 



riev^name fAramr^Irr nainct dcvdcr nanu! 

sItc and type: long ward poinoer Chigh-«)rder byie zero) 

rangs of vtIiks! JOOOO 0000-400FF FTTP 

The long word adcirKS of n httto TTic bolTef coniairis a length byie 
fntlciwcd b>' a.n ASCill slrJng fcpiEsc:nUnG Che device name 

vol_naniB pitrd.m'rtcr TiHinc: volumt name 

«iw and lypc^ liiog word poiiiiof (high-order bytP ?era) 

rUI]^ or vaJumi: JODDO OOOO-JOTFF FFFP 

Tt»e lonu wEicd liiiitnisi wTi bwrw Ihe buffer ccuMains a length hvtc 
foLia'^iCd by an ASCII string fcprcscnting the volume name 

(Ifidtidlfig a leading fi\3shX 
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Port D: ProDOS 16 Svsle«n Oill Raferance 



Pornin«r»[ dncriplbn Csonllnuwi) 



on 1*1 



UrM 



[Mienpllon 



S':js!^sob 



JOC-MF 



Jlt'-Sll 



trse bl^tka 



f lle_aya_id 



sixe and ty-pe: 
i^aztgc of vaJum 



size and ly;^ 



t.otfllbltjcks pu-amccer ndmci lotalblotks 

!□«([ wuni nMuLi fhigS-nrtfer byie Beic) 

sooro oooo-joorp ffff 

The («il nu fflbcr of Nocks the voiume cDCilalni 
fret htexiks 
long wind result (high-Of der bytf aefo) 

SMOC* OOCO-SCQFF J^fTT 

Jlie number of Tire Cunal locale d) blocks In the iraQumt 
pxramctpr name, rje s«tcm ID 
size and typn wDfd reauJt Oiiah-order byte leioj 

nwitjc of v^un^ lOrxiO-JOOFR 

A wiml TJ.hoM Ifjw-(ii.rfcr hym idcntiiics ihe RJe sv^ccn to which the 
Sptraficd fil* or ttiJume tjcbn^, 'nn! ouicntly deFrncd SHe syilcm 
idan.n fitaUon numbcii uiclude 

■0 ' [rcserwdii 

1 - ftoDQS/SOS 

2 - DOS 3-3 

3 - DOS 5 2. J. ] 

^ = Apple u Piscat 

5 - HaciiiKisl] 

£ - Wadnidshi (UPS) 

7 - USAS 

8 - Apple Cp/m 
9-255 ■' (icicfvedl 



Choptef ?■ n» HoLBekeapir>(j Calls 
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PoHibl9 ProDOS 14 errors 

W7 ProDOS a trn-iy 

110 Dtvioe not Jound 

$] 1 Invalid d^vJce i-cquc^l 

53,7 IVO error 

328 So ttevice conneoed 

32E Dish Ewiichcdj fiicES open 

a2F Device not .Dfi lljie 

S'iO 'Irival\(d. pjihciune 

JilS voiairtc no[ found 

352 UrMuppdiTeti volunw type 

i55 VnAunx cnnaoi bl::ct full 

457 nuplleaw volume 

356 Nat a blade dnlce 
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PcMt II. PfoDOS 16 Svitofn Coll Rslerence 



SET^PfiEFIX ($W) 

This funaiaci sssigm any of B pccfii numbers to the piLhname 
Lndlcued by (he p<.|tl[cr pcaf 4h, A prefix number cnnsi-aj *r a 

diSiLfDUowcdbyaslasEi; 0/, i;, 2/,.., 7/. -When jn 
applJcaiJGr staiti, iJie pjcfiics have defauiJt vabes rfiji depend ort 
the manner in which the piugram wi5 lamwJicd- See Chaplcf j. 

TTh Iiip4 paihnamc [q this fall may be 
□ ■ fill] pjifirumc. 

Q 1 parUaJ ps rhriimc with i ptcTn numlMf . The uuiling 5iiall on 
TJie prefii niimber is opiiofial, 

n a pa/dal palhaami: ^tih ihc spf^cijl prefii number '/ iajtcri.*. 
*l?*h>. whicfi rmeins 'hoot volume n^iiw.' l^e nailing sJjjh u 
<jp[iona.l 

a t partial pjchflamc without a prefix nuftibu-. In this <3£t ProDOS 
IS does «0( iBach the dcfaulT prnfJii Cnujnber 0/). Ihitead. ]i 
afifiends liin input paihiiamc lo xhe pirepLi ipcdJleJ in the 
pee E Ix^nutn Teld. 

* Afaw This mcihoj tin be used lu append a partial psthnme to 
in (Ulrjii^ preria anij. ir [Ik speofied prrlbi is preseaily niitl, 
wmt i^[) (Lnvalitl pathnajnE sj-niaij i5 renifned. 

SpwalFfinB a psthnamc whose len^lh b^le is ipro, or whose synuK Id 
eihcrwJ^ illegal, seis [he dcslgnaicd p.;cfiir ic iluJI CunassJgrted). 

♦ JVo^fe.- ProtXM 16 does rioj check to make sure iliat ihe 
■ifcsiafiaied valLitsw Is on Oirv when yoj spetify a prcfiii: il aniy 
checks Ihe pachrlamc strlna for congc! ayniajc. 

The boot vohimc prejUx (■/) cmnoi be changed ihroue'^ thiJ ciU. 




- VOIL* 



- pcnter 



SET_ntEF|X (JW> 

ParamefBr bloc It 



ChaplQf fl: FBa hEausakaopina Colle 



1^1 



Ff-r 



PaiQiTHilBr tJaitrlpMorii 



Ofrial 



Lobal 



SflO'iDl 



W1J-S15 



prQf±K_nLnii 



pzeClx 



0»icrip4fcHi 



tlixe snd typn 



word i-JUpfe 
Sf>n00-S!)M7 



One of [he fl pcefis nucfJjcra, La biiuri' (iwittiout s fcrmiftatlng 

piramftrr nainci pr^Cin 

size and type- Jang wanl poimef flilgh-ordcr byie mto) 

rwigiq of rallies: MOOO DWO-W&FF FFFP 

The l«n^ word address v! a bun«i. *lbe tJuIEcr cuntairts i teBigili byic 
'Fd^nwcd b^ an ASCII stdn^ fepfeserting a dirertmv pathu^mC- 




■ value 



- poimei 



Possible ProDOS l* errors 

^07 PraHiOS ts iMisy 

S40 Invjiid. paLtinamc aynia* 

S53 Pinme'*! «Jt nf iingt! 
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Poft II: ftaPOS li System Coll HBlarBnce 



GE1,PPEF|X (SUAJ 
Por^rrwi^r btocfc 



PQram*rBf deicrlpflon 



GET_PREFIX ($0A> 

This funcdon. rcrum.; any cirttK cufWfii piefiKe^ Otp«^Uicd hy 
njmbcf), placing ■[ in The buntr poJnCedl Id by fawflx. The IHUmed 
preTu bs brtdcrtcfi by slashes Csuch £3 /fiPPLK;' tn 
/apPLE/BYTE.S^). If [he irqurslcrf picfiE has )x«in S«1 10 fltaU (Stt 
SET__PBEri3l)r a cnunt of lerols retumed U the fcnglh byte in the 
pfcfur boffer. 

The baoi vijlume prefix C/i onaoi be returned by iTila all. 
Inaeuid, use Cet soot vol io Eifid the booi volume's nstw;, 



arit«i 



LdlHl 



D«i«rlpllari 



Wi-J[>] 



ioa-so^ 



prcf i K_n Lin paracii«ter nime: ptcfbt isumber 

Btet lAd type word i^uc- 

RuiJK Qf >llu«li SDOaO-SOD07 



prefls 



■One of the S pieFut nuinbaa, In. blnuy ^wJttlOUL A fciminatix^ 

pafam«Teir lumei pieFix 

sEic ^nd lype; long word pnJncef Chigh-ordcr byte aro) 

ranKCOfvalucaj SOCOO OUOO-SOOFF FFFF 

TTic long wonl iddreas of a bufTet, in which ProQCiS 16 (Atixi i 
lengLh byie tdSowcii by lA AStll strlrB reprejijfujiig a diiccton' 
piihname 



Possible ProDOS 1 6 errors 

iO? PjgDOS B busy 

J55 Paramrtcr out of range 



QhOptar •?: File HOtraekespIng QqWs 
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eUAR_BACKUP_BIT C$OB) 

This b [he MilK '^ll thit will dear ihe bickup trit in a EiJe'a »cccsa 
byle. Ontc ctciicd. iJie bit inditaics ihai ttte file has noL been 
alwreii since ihc lul bacfoip PioOOS 16 lutomaCiCiLll' fescEs the 
backup bil trVV^ iJmf a [EIf d; iltcied. 



Important Only diKi( twetup programs ahciufd use Ihls furcHpnl 



pgramaWc daKilpflon 



ori'«i 



latwl 



JOO-S03 



pdtimaiiiB 



polhnotTiB 



cainier 



CUAH_BACKUP_8rT (jOIll 



Da.icr1pllDn 



pathname 

long word polrtTec QiJgh-iKder hytc Mro) 

SOOOO OOOO-iOOFF mT 



p2ram«T<cr nanei 
size aad lypci 
rAUge of nJil«§: 

'ITw Ion* wwd addicBs cf a buHer. The buffer contains a Icnglh byie 
rolSowed by an ASQJ string represEniiiffl ibc lik"s pachfiame. 



PoBElbl« ProDOS U errors 



iO? 


ProOOS L^ busy 


$4fi 


tfiva.U'd. pa.thnainc syniax 


$44 


Palh not roucnJ 


SAS 


V<-i1n miT not fnucdi 


$44 


File ciM fownd 


S^A 


Vcjsion, ciTor 


S52 


Unsupponed volume type 


S58 


Xot E. btodc device 
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Part II; FtoOOS lA systam call ffefarercB 




File Access Calls 



I3S 



These TTughl bo called ■uprn-ElIc" alLs. Tbcy ate mark [c accMS 
and ehangc ihc irtFofmaUoji Within files, and [tieffforc in meal 
cases ihe fi[» ijuBt be open baton: the calls- cm be ma^le. 

The PwlXJ5 16 fJt access citla "* describwl [n che fQlltiwiuB 
rndtar 



Humlwr Funcnon 



^^ 



Part II: ProDOS la System Call ReferertSft 



PurpoH 



SlCi 


CJPEM 


frtcpitCE !ik- rtir aca:5s 


311 


HFMXrNE 


enables rBwIJnc stad rtKxl<^ 


313 


BEKD 


MansfEis dali T'O'n fiijG 


i13 


HRtTg 


IransFi^ns d^iW >o file 


-S14 


CU3£E 


ends access |o fife 


S15 


FLUSH 


cmple? UO buffci cm Hie 


S15 


SET MARK 


sets currvm position in Til*^ 


S17 


GE-Y PtftEUO 


TBI urns currml piMitton in fi5r 


SIS 


SET EOF 


sets sJa: oT file 


ii* 


GET EOF 


returns siBt of ftlc 


SIA 


SET LEVEL 


via syMera Eilc level 


SiE 


GEI LEWEL 


rtiurns sysicm File lev-rJ 



rel.num 



OPtinrwre 



- point « 



io_burr&r 



OPEN t$10j 

P aroma Wt biock 



FCrnm*i*f d&icjipllon 



Ollitt 

MiO-SOl 



SO2-S05 



lab*! 



taf ninq 



pathnamn 



iM-J09 



ia buffer 



OPEN ($10) 

Tii* Fumrtior prepares i (Oc lo b« read from or written lo It ociies 
3 iJJc Dcimwl blodi CFCB) thai hwps tiadc nf ihe runcnt 
litirtilcrislics of iIk fife specliled by pathname. It sas 1^ Cuncnt 
position in (he file O'lirtO to Jero, and returns a ttfcienct numbcf 
('P/_fl(im} Toe ihf lite; subsequent JHe access cjHi must lefer to ihc 
Eln by lis cefeiena; niimbcf. ic also return* i tncmury hatidfe k> a 
]02<-bytc lyo buffer used by FruDOS 16- for reading rtom and 
wrjung [CI the flic. 

Up w 8 files aay be open scmuliincmislt'. 

* Alalft- Normany, aiuimpcing rs open a fik ttiii la ■ItBi.dv apen 
causes an emsr Ci50>. l-lowever, iira flit U not urriie-enablea. it 
may be opettcd more than odct 



OiHCltDHBn 



airr and f^pc; 
rani).? Of Valun: 



reference number 

word lesuli [tiigJuarder byre wro) 

A&Ml-tMFF 



An identFyins ciuuihw liijgncd to C^ file by PinDOS IS. It is used 
■n plitc oT the piihnijne Ln all subsequent Hie ic«:ss csHa. 
pATanie\«i namci pathname 

size acd rype: [nng word poimce/ Qii^-order byte Tad} 

raoxr &f -rahiet- SCXXM OOOO-SMfT FFFF 

The Inng wnad addjiess of a buffcf . The bulTcr contains a Eetiglh bv-lc 
followed by an A5CII slrinH repfCscnlinE the psiJuiamc a! tic TJe 10 
open. 



piu-ouiricr name! 
al2e and lypc: 
nnfse iif val je& 



I/O buffer 

tung wofd r«ull (hijjh-ordst b-yw zero) 

StJOOU OMO-SDOFT FFW 



A memory handle. I[ points lO a locatian wbe*e ibc jdrtre;:; of die 
I/O hulfcf flitotale-d bv ProDOE 16 is- SlOrftl 



Crw^ar IQ: Fll» Access CqIIb 



137 



I 



Possible ProDO^ i& arrors 


$&7 


p!roIX>S is bui> 


$27 


I/O eircr 


140 


invalid, padhnamc sjiui* 


J42 


File tofitrol blodf lable fuU 


}44 


PiLh not fcwrid 


(45 


V<:!lumr nO! Eouisd 


S16 


Fiie not ffiurd 


S4A 


VeisLon crTOf 


K4B 


Unsupported sioi^fte type 


$50 


Me 15 open 


S52 


Unsupported voEume Type 



* 
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Pert W: ProDOS ifl sy*ram Coll Itofaiwice 



i 



This fiincifiPi enables nr dis^Nra the newlin* reid mo-de fo. an 
Open, fiJe ■nmjBd ncwiine is dijblett, a ElEAD cJI (described rWEl 
Canil naics only when. Lhc requejlHl number oF diMiaclew |^m hew 
rt.id (Linlws Ihe &id d/ the Tdc u ertniuntcred iiraO. When ™wlirK 
js eiiaWed, ihe hem wilt also lennJnaie whcr* a MwJine dniaaer 
(as defined in th« piraniewr blodO u read. 

WT^cn 1 KEAE cill is made and iiei^Qnc mode is enabled, 
t . Each diaf^ricr read in is n™ [ransrerred to [Jie usct's dam hjlTer 
Z. The d^raaer L^ AMDed wl^ [h= Jfwocdcr byte of the ncwlme 
enable maik {spcofied in th?. NEKLIHE raU'S pajarader bixkl 

i Tlic r«uji is compared wiih ihe low-ordec byic gf ilje iKwJine 

chlractcr, 

■1 If ihwt is a EttiEch, the tead ia terminaied. 

TTe cnabte mask fe lypic^Jy used W> mask off uawmsd biu in [Fte 
dtapaetn- ihii o lead In. For Mimplt, ir ihc mask ^-aJue w iTF 
OM^Vm \IW. ^ r^wU^y^ ch2.^eicr wfl] be CDfiealir matched 
"liahei- □£ n« JB hJ^ bii i5 set If the mask value is $FF ai 1 M 1 11 J 
the diMacier will pass through the KnQ operating und^ng^, 

Newime tead mwie is disabled by McumR tne c™We n^k to lOOOO. 



1 


i"e-'_num -i 


resull 




eriobl*_mDik 


VOlLIt 


s 


nBWiina.char 


valu« 


J^ortBTiBlar btcck 





Chapter 1 a Fie AocBD CciB 



1M 



PoroirrwiBr dttii\pt\on 



Lotwl 



DBKrtBHon 



SOD-JOl 



SUZ-lCf^ 



SO^-JOS 



Iff num 



enatile ma,9k 



n-Qwlliia chBE 



paramctEr nuDFi neferenLzc numbci: 

iiue and [J'IKe won! JWfljIl fhigh-aidcr bylc MfO) 

ranpsofTalDeSi StHKil-JOfiFF 

■|"he identiiyLnE numbei is5ig/ie[i to ihr fife by the OPEN fLiivaiDn, 

parameter dAllKi en3J:i>4^ mssk 

alM and lypc? wtmi vilue ffiigh-owti byw zeto 

ranac irf valyew SMOO-JOOFP 

The nirttju H*ifailer b ANDcd wish iha km ordtr bytt of this ik-ord. 

aJxr uLd lype: wartl viJuc thigh-ofiier tjyTe i=ro) 

r«0|r of vahicai S[>[lOO-S0[>FF 

Whalevcr diaratlcr ttt^jpse* rhe low. order byte oE (Ms field iS 
defined S^ llie newllne chara-ctcE. 



Pcsilbl« ProDOS Id errors 



j07 
S43 



PfoDOS is busy 

liiviliiJ leCbrence numbet 



liO 



Part INPfoDOS la Syntem Call RaferBOCfl 



When tailed., ttiii Function joempB to ttirafa iiv rtquesLcd 
number of bytes (sBaMr;g »[ ihc cuerertt ptKJUoji ot the IlJe .speciJjMt 
by fEjCiiWnJ into the bufffie pointed to by diiat_buffsr When 
finisttpd. itie Jimalwi raums the numbra- of b/lcs aoiiq Dy 
trinsferrcd- 

ir, tfurirg a fead, ihc Endl-of-nk u tearfied bcfoie «'?t«r;_cM(H( 
bylM hBVft been read, t canaf er_c:ouiit b set 10 ihc number of 
byies Enrksfcnfd. Ifncwling rriodr is enabted and 1 fitwUnc 
cfilfictcr L5 er^CQunlcrvd brfDn: requ&sl^couat Ijylcs hare brer 
read, i;rfl[i3fer_«punt is set [» the number of bites transfcrred 
tincludinH the nswWac byie), 

No more than l6,777,JJ5 OHT PF fT^ bjte nay be read Jn j sinjjb- 



D 
1 


'fif.njm 


- 


vt]ije 


3 

a 


dola.Quffer 


- 


Donw 


7 


iBt|UBit_cmjnt 


- 


voiua 


A 

B 
C 

D 


frortifer_OQurii 


- 


le^ult 



EEEAD (j]2). 



ClTapter ICk Fte Accaa Cofc 



IJI 



Porerrwlw dmcrlplfon 



orrnii 



D«ienpMn. 



iM-M1 



S02-5Q5 



106-509 



SOA-iOD 



taf nuic 



sJzE aod type: 
ivngf of values: 



(i^ff^ifncc number 

wDpJ viLuE tW gh -order byie z«oJ 



detB buffer 



Tbe JidEniifylTig number a»Jgned lo Ihe fQe by Lhie Of EI4 CunOcon, 

puMiifieter nant«^ ijau btilTcr 

size and typ?: 1aiji wotd paLniii^r ChiRh-prdcc byte rfin) 

raimc of nduesi iOOCa 0OD0-$OOFF FFFF 

The long ward a.ddrra5 at a. buScf. Ttie- buffef sticuld be tar^ 
tf]6tjgf\ [o hoU itte ff qurared dan 

cequeBt_cDunt parameter luuiKei teqii«l omim 

lizc and typn 1'')riS word valur Oi^ghrnrdcr byte zCro) 

nwHe Of »BliMS: SOOOO tWOO-SOOFP PFFF 

The nuinber of bvtes to be iiaJisFcnEd- 

tran9f'ee_caun^ pBfHcictcr nHmei transfer cnunc 

si«f and ij-pit:: lirmg wcitd re^lr t])ig:h-a«te« l>/i£ 2erc<> 

rdn^ ti^ vahiHj SOOOO OOCO-SOOfF FFFF 

'iTie lOuaJ rtun^rorb/teS' tra.rts[en«L 



Po»lbl« ProEiOS \6 *rTor» 

S07 PfoDOS li buiy 

*27 I/O errtiT 

$^3 Invalid, rcfcirrar number 

*4C ^XJF ereounctfed tOut oF daa) 

S4£ Acu;^: nCc; tint j'cad -enabled 
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Port II: PicDOg 14 Sy^lwr Coll R^t^r^ncs 



WRITE C$13) 

When dEled, Oti» (undlOn lUunpla to transfer th? jpeciCkd 
rtumbcL- ol b>iE5 fcora [tie bu fFer poinied [u bv /^aui_buffer to ifae 
file jipedfied by ir/LnufB (sLaniriB it the oirrcni position in the 
fJe). Wbcr finished, the functlun i^wrdi [tie ntunbcr of bytes 

actually irartsreired 

AAcr B, write, the CUffeni fife pusiUan (Mark> Li increased by the 
tSflSfet ODunl. If ncocssary, Ific cnd-af-Ue CEOFJ is eslftEtded ID 
accomodite llie new djiu,, 

No mtjic ihan 16,777,215 fit'? ff FF) byias may be wriiDcn in a 
single c^1l. 



rstnum 



- value 



regijebt_-i:a>jn.t 



data_butter - poirsler 



1ra«iBl'er_cDunl' 



vgiut 



mutt 



PaiBfV*l^ block 



ChqptSF ID: FII& Acc:s5s Calls 
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PararrtWl»[ d«icrtpllnn 



lalHI 



Daicrlpllon 



slie and type; wcad value Chigh-oriSeT byte iCf d> 

fanRc of 'vJuesp lOMl-JflOFP 

ne iricnufyLnij rmmbir/ flSEiened [o iTie fifc by Lhc OPEN FuncnorL 

S02-S05 data_Ljffar paraoicltr fljun*-- dMabuffci 

bIe* i<id type; \v(\^ luoid painter ■ChighHScdct byte zera) 

ranuE o/ valuci) SOOOG OOOO-SMFF FFFF 

The lung word addicss cf b buiTa. Tbc bulfcc ahouW be i«rgc 
pneufih to hold Lhc iieqi.>ested data. 

SQ6-ift& t-aquaat counf. paramdcr ■ULtH'C'J J^C[UCSt ccKunl 

sLm and type: loms word value Chigh-Dixler bvic k^o) 

na^ of >ndu»i SQOOO OOOO-SOOIt' TFFf 

The number of bytes m be Lia^ufuied. 

SOA-SOD tc*ft***r_cDiiTi- jtamnectr iLunn. uansfer cotiiiL 

Htrr and lypti ImiB word reaulf (hl^-oirdcir byW wwl 

ranJp^ of rtluea SOOCS (MOO-SOOIT FFTT 

The iclual nvirtriT^c qE bytcB transfcTTei 



PouibLe ProDOS M «rrori 

5D7 ProOOS i* busy 

»27 I/O error 

J2B Disli wTlW-p<flWcfcd 

i45 InviLid rcfcxencc number 

(48 VdLu me fu 1 1 

He Acces-^: FeLc not wrile-cni^lb^d 

$5A BiDdc number out <>r luigc 



CLOSE ($U) 

Thii rum-Uan is dUad lo teteise aiU ■csaufces used by an open fit 
and teftninaie Further acctg^ m it Tlie file cantrol block fFCW is 
reteased^ if mcccssiiry, the fitf "s I/O bulfcr 19 empcied [waiiicn la 
disk) and [lie direaory cniry for the file i* updated. Once a file is 
dtned. any subsequem calls laauig Jis rec_fium will Jill (imiil chat 
number is sssijiicd lo anoUier open SM}. 

If Itie jpedlied iref_niiin ii 0, aJ] open Ii3es ac nr above ifie euncnt 
lilc Icvd <&££' SET_ LEVEL and GaT_LEVE[, tails) air closed. For 
enantple. If Kits bie open a[ level* o, I, and 1 and y&j have sci die 
oincnt level 10 ]„ a clcs^: sillwiLh i.st_rn3m ^ci loO will dose alL 
Bcs at Icwcis 1 iJld 2, bul leave fites HI ]evd open. 



ref nuiTi 



Ul^luq 



P{]rann«ra[ date rl prion 



QIIh! 



iQDfl 



SOi>-50] 



ref num 



CLOSE >($IJ) 



(taicripHati 



paraxoiirtcr namei 
sL« and iyptt 
range of tbJues: 



refcienic mjmbcr 

WQtd value Chigh-order l>)ijt Wici) 

Moao-JooFF 



The Ideniilyina, miimbef a»i£i^cd [□ the Cil« by the C?Peh ftinaltm 



PO»lb(« PioDOS 16 arrors 

t07 PraDOS IS busy 

127 I/O erirw 

i2a Qjsli nnile-piolccwtl 

i^i Invalid reference number 

35A BEtKk number oul of range 



ParaiTMlM daserlplilDrf 



□TFl*l 



LC^Mi 



S(ja-*oi 



r«t rum 



FLUSH ($15) 

tliis funditin i3 caPcd to empcy an open file's b«/fcr "lul upOitii iis 
dire:t.l0[7. H" ±Bf_m]ir is zero, il] open Files ue JliiiiS^fl- 

* !</o(e; Cuncnt vsralonj of PinDOS L6 iarore re/_nU7H in [hi-i 

call The FLUSH call flustKA aiL apcn fles. 



?E 



re' rium 



FUISH [$1S) 

Para mater blrrdf 



-\ va 



[t*i^ripin<Ma 



parameter UAiUe; 
rsctiie nr values; 



wurJ value (high-ntdiie byie zero) 
JOOM-SOOFF 



Tta fdcntilytnjj mimtwf isslgiKtl lu iht Hln by the OPEN fimdion. 



Possible PfoDOS 14 errors 


iB7 


Pro DOS Is busy 


S27 


I/O crrtir 


UB 


DLsk wiilc-procecwd 


M3 


[nvalid r^rcn:ni:c number 


i*s 


Voluine fjit 


J5A 


tUtxk numbcf «ii cJ range 
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Parr Ih PiaDOS 16 Svflt«m Coll Relarsnos 



Pa^matar (toKrlpHtKi 



did* I 



tt^al 



S[H)-50t Mf num 



JOi-505 prisitic 



SET_MARK<$I6) 



Pnr tlie specified apcn file, IMj timctlon SCLS ihe CuncnL pixitign 
(Mirk, ihc posillon st whif h subsequent [cadinjj and wrl|:Jny wj|[ 
ocQu) ici Eh< point spccLTtcd by llu; posiijon paninclci. The value 
erf [he cuncnL pnsili-on nt^v ™j[ tjtaxd EOF Ccnd-of-lile; Ob idse (tf 
Ihe file in byiesj. 



rer ng.-Ti 



- value 



poslMgn 



- vqIub 



SEir_MARIC C£16> 

Pcir(jnT»l«( aiock 



DHcriptipn 



poiaiE.'Eter name: 
ran^ of Villtica; 



rrfcrcBicc nuniEKr 

wofd value Chj'fih-order bvie sem) 

KiOOl-JMFi-- 



The Jifcfitiry-ing nuiiibcc awl^ied 10 [he (ifc by Uifi open furiaion. 



ftar^iuctrr naJiin 
«lzc and lypci 
range of bluest 



poslLiGn 

lottg sjorj value tjugh-owtej byw xend 



Thti value assigrw^d lo Hark, IL is [In: poytoai, In byBS rctitlw! Ui [he 
l^Einnina of [he file, aL nhidi the n«n wad or wiilc 'niD tWCUC, 



POislblfi ProDOS 16 etrar; 

SOT J-ri^IXJS a buiy 

J27 l/'Q cmjt 

S4J Invalid reFerrAce i^umber 

!^D PiMi[iQn rsiit nf range 

S5A B3ock nitulvT oui of lange 



CtUphH ID: File Act^^fg Calls 



MT 



1>a(DmAI*f d*uJl;3ll«n 



oriiai 



Udwl 



JdO-SQ 1 



SC3-S05 



fcf aum 



positiori 



GET_MARK (Sl7) 

This fiirtoion rsmms ihe cuftcnE poaiUon tMarit, itie poslUnn il 
which sutficqu-eni reidins anJ wiilJns will otcur) far ihe speciecd 
t}pca flic. 




- vol Its 



- unlue 



PQI'OTWiv block 



C««cr1pllart 



sIm and tvpci word vjiiue (higli-order b)Te zercO 

nuiBc of valiws! 400CH-SCWFF 

The idtniiBying nuraticr assigned 10 the iilo by ibe DB-EM runrinn. 

piaatOSW^ aamci poSiliCn 

jilic and type: Inng "■""^ r«ufi: Ouj!ta-or3« l)^1e acm) 

raaige of values: tyCKW raxxKSOOPf S--FFF 

ITie currtnl value uT t-Urk. It is die pOSJlian, in byTftS reUtive K> Hv 
hcEinftiflg (^ the filie, &L (rflich the neat read W write -ndll oaxi. 



Potslble ProDOS 1& errori 



tt7 
»43 



FtdDOS is huiy 

Invilid, rtJsteiTC* number 



14B 



pqrf II: proDOfi. 16 SyslBTi Col Itefersnc© 




- valLie 



SET.EDf t$1Al 

Para male r tXocH 



SET_EOF(Sl8) 

For thr ipedJied file, this (unaiaa sets its loglnU sim fln b)ifi*> w 
the viLue ^WCiTied by tOt" Ccnd-of-fijc). if ihc spcdficd EOF is Iesj 
ihm ihc cu rrcnl EDP, ihcn disk blocks put ttte (lew EOP IK lefcassd 
to liir si'stetn and Indei-bloek painlcra lo ibnsr blcwis mc jcrccd 
However, if Lhc specified EOF ts equsl to o( gieiter thiii she airreuE 
EQP, no new bkrda UC alkjcalcd untE dm am adiully wrJUen to 
ihcm. 

Tbe vaJLM of EOF csjinci be dianged unlau ttK fDe Is wfEtc-e:nibled. 



?aram«ai dsscHptlan 



OHlBt 



tatHi 



Daieiipiliin 



SDO-SOl 



S04-SO7 



ref num 



«of 



parameter name: 
ran^ of values: 



refercrcc riuinbcr 

wwd irjioe tWgh'Oftter byre icro) 
SQDOl-SQO'FF 



The iddiiifyLna Tiiimbtir assigned Lo the file by the deem Huuslon. 



parameter oamc: 
^Izc snd i>'^: 
rangr of TS^Hti 



end-rjf-filc 

fang ward value i:higJT-onJef byte Kid} 

iWCa OKB-SOOFF FFPF 



The specified IfJaioiJ size orthe file. It scpicsails the total numb^ of 
tyytK that may be icad £^ini (he [i^ 



Pouffilo ProDOS 16 erron 


J07 


PtnDOS 4s bwy 


S27 


yO enai 


S43 


hiv^lid rcrerenc« niimJw* 


iAO 


PcHiLidh out of ranRC 


iAE 


Aioess; file 00[ wnlC-eHablcd 


S5A 


blddt mimbcF QUI flf ruige 



Chapter IP: Flo Access Call& 



U9 



MW aW M ducftplton 



OTiiai 



IsiM 



son-soi 



so^-so? 



rsf TikA 



e-of 



GET_EOF($19) 

For die ipcdEcd open Wc, ihis fuucuon jwuiiia iu LogJcal sLic, ■> 
EOF Ccnd-or-rie; ttw nuniber of byics fhii -cin tx read from JO- 



ffOf 



- r«ijii 



M!_EOF (Si 9) 



DaieripHon 



pirameKr name: icfciCniM numbcT 

bIs and lypH wottf value Oiifth«order birfC sero) 

ront^ nf values SoOOl-SCWFT^ 

The Ldenlifi'mji rtu ftlfcet ji5il|{nEd lO [hfi file by (he OP£M fyinction. 

psTBinrtti' tuuncc cfld-oMile 

slsc Bn4 '■rp'^ '<^"'S -h'frid Kiiili dhigh-unlec b^ zero) 

ranHfCorviaum $0300 OOOO-SOOFF FFFF 

llK curreni Igsital ^izc cT the file « rcpteaema ihe una] mimber rf 
bytes thai inay be read fraixL ihc fik. 



PoislblA ProPOS 14 errors 



M7 
$45 



ProrXJS is busy 

Invalid rcTensace nunibcr 
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Part ri: ProDOS 16 Sv»t«n Cgll Rafsr^nos 



PotomelBr civKitpllon 



on±»t 



Lobri 



JflO-SOl 



level 



SET_t£VEU$1A> 

This tijrctioii sett the curreni rahie nf ihe jysicm fflp level <«* 
Chapter 2). All subMquen OPEN ails wilt a-isigri ihis Ici'cl la (he 
ftlcs opened. A]l subsequent Clqse calls for laalsipk files CihiL is, 
ihtBC uUs ygiflgi t spcdljed caf^nuni of 0) wj][ be effective onlv 
on those fiks thai wwe opened wlien the syston Icv^l was greater 
than or equal to ihe new fevel. 

■rifc raTige (rfle-^ sjstcm 3evel valuta is StlOOO-50Q'FF_ The iiie kvel 
inlElilly defaults lo MfO, 



1 



- «aij« 



3Ei_l£VIL UJA) 

Paronwtar fnock 



IMtCrfeilten 



paraa»*ier namei syMenn IJle level 

Sl.M ind typ«j wokL value ChiJSh-Ofdcr byte zi^oJ 

«n.K? ofvalucBi JOODO-MOFF 

The apcLined value of the S^Icm (He l^i^l 



Ptis¥lbffl ProDOS Id errors 



507 
15S 



ProDOS is busy 
Invilid flic leiicl 



Choptar la «a Acc«« Calb 



151 



POromBlV' qtaicrtpMon 



criict 



U(M 



StJOJOl 



iBval. 



®Fr_LEVEL<$lB> 

TWs funadoii iwums ihc cuuern v»lur of :he syfilism fite level (see 
Chapter 2). All EutBcqiwnt open alls will assign *i5 le^'cJ tiJ the 
EilM opened rMI siihscquenl CLOSE ciUs ft>r tnuHlpie fLlcs (ihai Ls, 
those calls usinR a speCiHcd ref_niim yf 0> will be effective only an 
ihose fil^? tlui *rre npened when L^le syWem level wis greater ihan 
or etfual lo lU current levcL 



Ibvb' 



- resjif 



Paromal-Bf titock 



D«»eHpiian 



pdfaincter rtarae: svsicm fife level 

size Bud lypei wofd result Oiieh-ortfer tyte mio) 

"The cunresu vatoe of ihe system FUeJevel. 



PoHlblo ProDOS 16 fliTors 

J07 ProDOS is bitsy 




Chapter 11 



Device Calls 



1£2 



Part II! ProDOS 1* Syttsm Call ReWirenca 



163 



Derirr call* s«eM MOJajje devLoea directly, tathcr Thin thcough the 
logical iiiticturc at Ihc v-tdun^S fir fElca on Ltiem 

The PreOOS l5 device csHs "ic dcscijbftil In the fallawjng oide': 



MmM) Fupwhan 



hiipai* 



$3D GB'r_OEV_NDH 

j21 QET_LA5T_DBV 



122 
114 



READ_BLOCK 

l*SlTE_BL,OCK 
FQHHAT 



irciurns a device's nu^wber 
renirnd Hie la^t levies 

tranifeu 512 bytes fforii i 

dcvica 

[ranaTers 512 byi" lo & device 
rocmals n volume in i dcvia: 



GCT.DEV.NUM ($20) 



II 



- poinhef 



dev.narriB 



rSSj' 



GET.ChEV.NUM (}») 

IPLilarnatei olock 



t'ammalflr doKriptlan 



0!h*t 



Lnbnl 



iQt)-S05 



(JQV naos 



SM-SC5 



iew nwr 



For ihe devire specified by name or by tJie name of [he volume 
mnunlf d. an LI, ifai;. Eurclinn nrtuma jls dfviirc number. All bCtirr 
device ciSls (ejicepE for FOBMftT? fnuM refer to Uw device by Its 
number. 

Deviix numbcKJ ne migrted by PmDOS 16 ii system Autup (booQ 
tim^. Th^y ice cmuecutivc Lnte^rs, asainned in the nniec in whl4:h 
FhjIXJS i6 polls EKwmil ilevicw (see CJiaprer -C. 

* jVoii? Because a device may hold dlffciefii valiitnty and 
hccausc VGljmes may be sailched among, devices, Ihc doicc 
llunlbec rcLumcd Fde i pairliijuUi vvlume n^ixiic miy thiri^c, 
LikewiK, the vulLime luimc if^odt-eil with a pjrucuUx device 
ntimber may chajise. 



MKrlpnon 



pafftmetcf nuBCi devi4% ndrtie /volume name 

ali* And type; long w-r>rd paintci thiBh-nrder byte TcraJ 

raoac Df vahicm SMWO OMO-SWeT fTTF 

The ]aiifj wend itldnss af a butTer The bLifTeT cojililliWi % Ignglh byte 
fcilji^wcd by an ASCII sliing ccptchcnLng the device name ue [he 
vatumc Jiajne. 

paj-amei'Sr namet device numlber 

size aad rype: word (csuli Oilgti-ordef byie Mfo) 

range of values: $coaD-$4]orF 

ThE device*] refeience numbet, to be lued Ln other device calU. 



PDsslbIs ProOQS IfrMTors 

507 PnnaoS L) taisy 

StO DcidCc ntjt found 

11 1 Invalid tfevlte requKS 

Jkili.1 [riv^lld UcvKc iLiiitc »yi]LdA 

S'4!) Volume ntjt Tnund 



Chiop'^r II; [Mwtca com 



Faramai«i( aaKriptlon 



OTfHl 



Lobri 



SOO-SOl 



dBV niim 



GET_LA£T_MV (S21J 

This function m^Tti* Uic dev.^ ^mb^r oFihc 1j^ d=.L« =toes5«l. 



14 



'El 



- "BWlf 



SET_LAST_1IEV 1421) 



iMi^pnan 



□arBi£iCtEr luunct dei^cc number 

Hlw and lyi^ wofd resulL thigh-arctef byic ^^c) 

range of ™lu«S' iOMO^tOOFF 

The d=viK's refcic^ m,mb«, lo be uscd In Othtf deUM oJU, 



PDUlbIt PioDOS 16 arron 

407 FioDOS n busy 

J;£q Data, ut?* vail able 
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Part 11; ProDOS 16 Sv^om CoB Rsfweriea 



READ.BLOCK ($22) 



This Functinan reiiii one b1odc of [rtformaiion ftom a dlsl< device 
[j-prrJficd by dff^^TiU'nO LntD mcmnry starting j.1 ihf addicss 
(KiinKd lo by tMaJfu^i^- The buir«r ntus! be « least 5T2 byres in 
length, because cxistin); d^vic^ define a. block is ^12 bytcE. 





1 


dflv_rium 


- 


vaiua 


■I 

3 
5 


tJ(ifa_burlsr 


^ 


polnrsr 


S 
& 
9 


tj tDC li.nu m 


■^ 


vqIuS 


KEAD.ILOCK (122} 

Paramatar blcci 







PeratnaPBr doicrlpllort 



;^n:t*t 



DMOnpHMI 



SOO-SQl 



S02-305 



SOiS-SiM' 



deu nun 



data bLiflei 



block noic 



paranicicr fiatu«: devife mimber 

sItc and type- word wtue QUfthofdef byCe awoJ 

ran£c of vaJues^ 10^00-10017 

llic iJtvitc's rcfLiencc number, as icliirncd by CET^DEV^NUM. 

par^DDctrr nainei dau buffer 

sbw iuid t>p« lonj woid pnlntcr OilKh-Drder byte zero) 

ffltLRC of values: SOOOfl COOO-SMf-y fThT 

The iMift wnrd addre,'i3 cJ' ti ixilTer ihat wfll hold ttw data to be fCild 
In 



parameter name; 
frCte add tjiMrc 
ranftc afrabuffn 



block nuii»be4' 

Lan£ WQcd value -Chigh-oidci' word xeiai 

soooo oooo-SMOo ntv 



The numfaer of ihc block lo be read Jn. 



Chopt*r 1]:Dcivk;BCafe 1^ 



POtlftri* PrqDOS 1A ttfTOra 

157 PraUOS IS busy 

31] Inviitil dj::vii:c [cqucsl 

417 I/O eiror 

$28 N'd device izonncaed 

SSF Device rwton lirw 

$53 Pifajneter oi.ii of ran^ 



IBS 



PcBl IL ProDOS 16 SvDwn Cofl Bstefenca 





r 






^ — 


1 

2 


■ dBV. n y f^ — 


^c".e WRITE_BLOCK (i23J 






i 

T 

9 


□aTQ.D-jrrm -1 


potiiE' ""^^ ftinaiOfl [ransFeig one block cfdlla from ihc aiciuaty buffer 
FwJrIed to br daJii_buJ'Brlci the disk device spcdJJcd bv 


btock.rirtn 


da^_KUm. Tie block is placed tn Lhe apcdEcd lo^fica! hEock of iPlc 
voiLw ''°'^"« occupying thai device, J-'cr airrenily tJcfined devices, the 
rfaia buffer must be al ieaii 51i byres Jong. 


WmtE_BLDCK <S2A) 
pQfamaier block 






ForamsiBr dAicripfioi 




Ol 

id 


it»1 Lobal 


DaacMpllijrT 


VJl)] ciBV_rt™n panunetcr lumcc dtvicc number 

stie and type: wnrd i-aluc ijilgh-ordcr byie iwfci) 
range of valu^b 5UDOO-300PP 




The (levi«"s jcfcicnce mimbcr, is retjmcd b/ 3E.T EEv KUM. 
M2-S05 dftta^^huffar parauictcr iMimtt data buflcr 

size azi^ lypR Inrg wofd, pomta CJaJgit-ajdcr bpe scm) 
range of vjJuM! SCOOO OOOO-SOOIT FFFF 




Thi> l-ong wnrd a Lktrris nf a bjPTcf thji holds the data [□ bn wriCKfi. 
SC6-*&& blcclt niuu parameter nHine, bJodt ruimbcr 

si« ^d (ypc: Jong ward va l(je Oi^-orelef toord zwo] 
i^ngc or vaJucsi IKMU OOOMOOQO FfFF 






The luiraber of the Modi in be wttaea tii 


Possible ProDOS 1^ arrofs 






S07 ProDOS Is buisy 

Si 1 Invalid, devlw rrrpaest 

J27 I/O errar 

J28 Nc dpvite coruiccietl 

*2.E I^ijl< w rile -protected 

S2F Device not on line 

i^i E'arjmctcr out of range 






Chaptar IhijBvteo CoUfl 15P 
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FORMAT ($24) 

TWs riinEMJon fomuts ihe volume (disk) tci ih= ipedne4 Ctr namej 
devJf^j fliving iL ihe specifbed voEumr name The vnlunic Ls 
faimaued tixoniin^ to Ehc spct^fted. file syslcm 11^. 

* Mite,' Cu-TTcnt verSiuna Of J'loDOS 16 suppcUl fonmatiinB Fqe iht 
PidDOS/SOS Jlle system only Wle sysran ID - 1>. Specifying 
any diIk' ni« ayitEm will gen«niK «td' S^iD' 



Clewngme 



tioLnortie 



'llB_1«Jtl 



EAimGr 

pant*r 



KJRMAT (124) 

PararTwtw btocfc 



?arsmil»r dnciipHon 



Otlwl 



lotMJ 



iMKnBit«n 



JCO-SOJ 



SD4-S07 



ilev name 



vol "HI" * 



lilzf and typ^ 
rutge of i^iM?«i 



de^cx name 

WOOO GOOO-iOOf-r CFFF 



cnji) 



nie LtHi^i wmd address af a bu [fer, The bulfa cantairM a itfigih byic 
tollnwed by an ASCH string represoicing liK devJce nimc. 



uo-lun^e name 

lorvg wtffi^ poiniffl' Chi^-arder bs/ffi TCroJ 

icooo OOOD-SGOIT fr-t 



p€faiu«ier name: 
size and typci 
range i>r valuesc 

The long ^ord address of s. buffer. The buRsr oonliins 3 lenjjiJi byw 
fcUowcd by ao ASGI String repi.eKfiiinK thr voJjfne fiime 
Clncliidjng a lending s^aM- 



1« 



f>Cfft H: ProDCM 14 Systwn CqJ [*arftf*nc« 



J03-$OP file_5ys_id paraoi^ter nuaci: file sysiem ID 

aJiT BJid trp» ward reaJi Chigh-ardcr byte wro? 

irvngf of values: iflOOO-iOoPF 

A ucird whose Jaw-ordef byte jdcniiTLcs the file system in wtiicli Ibe 
fnrmatted volLJiiie bclanss. Tlie currenliy dcJlned file ayslem 
IdcriCili^iiJoii numbers m elude 

- IfCKEvcdJ 

1 - PtoDOS/'SDS 

2 - DOS 5 5 
i'DOSyz, 3.1 

i ' Apple 1! Pisal 

5 ■ Hadnrosh 

6 - Madnlosh OfF55 
7-USA 

a - Apple CP/W 



PosslUa PioDOS 1« «rrois 

WT ProDOS is. hiriy 

1 1 Deviifc: no! found 

i 1 1 ]nvjlLd device reqiicsl 

iiT I/O' taroc 

S5D File syjKni (IM avaflahfe 
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Chapter 12 



Environment Calls 



TQ 



These cilLs deal wilh line Apple IIC* opefjting envErcsnmcnt, the 

scriware' and hsrd-wj.K conJi^ratinn wilhln wtiich iSppll'C^lioriS !V0- , 
They include calls ld siin anil end PraDOS l6 appli<:3,ti<jns. and la 
deurmJAe piahfAcaita and vcnions at sysicm s^dCcwqie. 

Tlie PioDOS lii tnvironmcni a.\ia are descrilbeiJ In "lie fpUowii^ 



HUFFdW 


SijncHon 


Purpoi* 1 


$27 


GET_NAME 


returns ipplicacion fi]c:ii.iinrf 1 


&2S 


GET_BO0T_TOL 


returns FrnDOJi l6 volume U 
nime M 


i29 


QUIT 


ictmirnta prewnl appiiaiitw™ 


SZA 


GET VEIRSIOH 


patums PrsDOS 1& vcraroa 1 




©Ef^NAME ($27) 

This fimojon relums ihe flStname of ihe turtrnliY running 
appliciiian. 

To flei The ciMnpeu: pathname of ihc mnrnt applksitfcn, uk 
G£T_eHEFIS For pfcfut nLjmbcr I/, j.r>d aflU [hit ptcELt to liie flle 
naime- fetumcd by this ciH. 

♦ Abie.' ir ycuf piogiam uses SET_PM:riX lo rcsd prefix 1 / to 
ailylliijlH other than tu inllial V[b]uc, be siife ii Tirsl usc5 
GET_PEfcEf IX or 1/ and saves ihe icmJis. Oihcrwigc there my 
be no way tn ee-cover ihe full pathname of ibe cuncat 

applJ^ailD'CI. 



data.tuirre'r - poinl4i 



GET_BOOT_VOl <^m 

Ttiis Ajnoion iciunu ihe name of the v£>lLin>e From which ihe fJe 
rumsd PBODOS WIS Lml fineGuBd erodos ii ihc cfiefiiiir^ 
jysicm loaiier: i[ li>ai? l»Qth PioDOS l6 ^fiti PioDOS S inio 
memofv Exccuiion of FRODOS miy gtcuit 

O al sysicm startup 

□ by ejrecuUon fnjm an Applfsofi BASJC dash C— 3 fommatid 

n by loaniiia prodos into nienioPi' st S0C120OD ind execullnB a 
JMP lo thai add(«» 

TTic volume nAnK tetumprf tiy Lhis call 1^ idftdlicaL cn the prefix 
Spedfled bv '/. Sec Cha^ptcc 5. 



J 



( 



GET_NAME tSSJ) 



Pofomaiw dmcrlpllop 



CHitr 



laDat 



cripn^n 



SCi(l-S03 



Jflta buff's r 



parameter iLainc:: 
size and typf: 
mniff uf values: 



tialA buflcT 

ItHig wofd porfltef thi^-Didcr b>tc jcto] 

JOOOO CODO-^JOOFF FFFF 



The lung wnrd iddces-i cJ" A buJTcr. Tbc buJfci tonwins a kiiglh bjie 
I'nllowecl by an AiOJ stjimg [HspreMniiinu ihc curicni appJjcatJnn'5 
nje nuDc 



Possible ProDOS 16 errors 

iC>7 ProLJQS is buisy 



Choi^tflr 12:EnvArDnrTtan1 Calls 



ibS 




T 



QUIT ($29) 

Cailinj! this tunoJon I&rtniniies [he present ipplitadfln. [I also 
cI'MiS ill Dpcn Eitcs, sets the oiit^tn sfilSiH file level tu zero, ind 

rfcalbdiCS H\y ifis[a]}cd Lnlenupt handlera. ProDOS \6 can dien 
■tto Ofie oT thice thinfls: 

n lilJrtCh a filcspccifiiHt by the (pjLlIlngpiOgrain 

D latuich 1 fUc spedEtcd by ttK us£( 

n lutrinuCfClEly JlUndi t pragnxn spcdrLnd [n (he qu(t lelum ftack 

The qolt [QtiLm Bta£k Ls a table nuintained. Ln mc^iruMy by 
ProDOS ii. IL provitlEs » cofV^nietll means for a sbcll program to 

pass Dcajllon. irj Sub^licLary programs Ccvcn cWhief ihielfs), while 
enawWfig thai mntmL cvefuually fecutfl* lo [he shcK. 

Ffi* exampte, a ptciyani Fielcctnr may push ils User IC onio [he tfiiJi 
reisjin Matk wliefkevijr li laundTea in application Cby making 4 Qt]lT 
taJ]3. Tint prngmin may or may nor speciTy ^-ct innihcr pros/im 
■when iT ([ulia, and il may or may not push ju rtwrt Uspr TH tinto the 
qijil cerum jtaclt Evcntuilbji, !h'T*nevcJ', wliun no mure piDRiams 
have been spcciOed ariiJ no nthcra arc wading. For control, to return 
lo thcni, [he pnigrara sclcOnv'i I.J*ef ID u^l|| be pulled fiom tJc stack 
iful il ■will be ciMTinjteiJ Hjfics ^ftaiji. 

Two QUIT l:iII paiamciCTS equltdL tttssa optinns, ae fallows: 
l.Paihciamc poinlfr' 

J. U JiE piihname painuer in ilic pnrametcr Wock pcmis to a 
paTJiname of aaazQitf lefi^ih. [be indialcd prasricn is loaded 
and cxeculSll, 

b. ir pailmamc is miD ticro) Of if il points tu a nuU pathname 
(□nrc with ] feto length b/lcj, ProDO.'; 16 piilta a L'ser 1L> from 
the (|ui[ leCuni stati anj ei«cut(» the pragiam with that ID, 

c. irpaihnartie is miU (and ■the qij'i letum siadt is empty, 
ProDOS 16 Mceojies a buLll-ici LnlEia-ctlvi;: ilJ*pilt(.+ier [hil 
allows the user lo 

D rebooL [he compLitci 

n cEEcui« the GJe Stsrat/ si krj on the boot disk 

D cmei the nante oT [lie notf appEucation |o l4iirn:h 
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1 




2. Fkg ward; 

The (lig word conEilns iws bootcan valties-: a ectum flag and ) 
iCi lift- from- meiTiarv Jlag. 

1. irihc tcLum nag valiw i'. TKUE fbU 15=1). [^e User ID O^Mx 
piugram mikifia the QUIT call is puihcd nnlii ihc quil return 
mrk fi''[lM reHim fUg li FAI5E, rw ID is puahud nntc ihc 
Stack 
b. ir [he i^uc of iSie ecslin- from- cue mO<V Sig is 'tftHE Oiil 
14-33, ihc pcosram ia capable olbeinR n^starwd from 3 
donnant sUtc in ihe eompuief's mcmujy. If ihc le&urt-Jmm- 
memoT Hag ■» false, ihe fimaram must always he reloaded 
from disk when it is n<n. Ereiy to^e a prosram's Usci ID lj^ 
□Lidied onlo the quLt return aticlt. the InrnrraalLon. from iWj 
nag Is Hvcd aInciB with a. The S>-a[eiri Loader uses this 
infonnninii when li reloads or restarts ihe praKra.m later 
(see Chapter 175. 
4> Note: The pathname designated in (his all rtiay be a piidal 
Dolrr-'Br pathname with art, implied OT esplidL prcH.* number. HDwev«/, 
the total length nf [he CKpanded pj-cHs (the full pathninm 
cxt«pl fcr Ihc Ttk name) must nal cxcwd f>4 chaiiciers. Olhe 
*'°'"* PfQDQS l^ taLliS do nrtl fC!iUic[ paiSinarac leost^* " acvefCly. 


a 

1 

3 


pQhfTogme 


ridiji 


II Qtin !S«! Fuither details of the opcraiien oF the QUIT fiwicriuii wp ^M 
1 poram^tar block espUlncd in Chapter 5. ^M 

16S Part Ih ProPDS \i &faem Oofl Pelet^nc* ^M 


^^^^^H 





PoiomBiar rfwcrtpllor 



fS1f*»^ 



iQbal 



S0O-SO3 



p^tJiname 



io-i-jos 



tlagt 



I 



MtenniiDn 



size and typcj Idhe. word pojfiier (high-&rdcr bjrtc tcifq) 

range of vaiotsi SOOOO OOCo-JOOFP FFFF 

Thr long tt^(J idiJicss of a bvlT-gr, 'tlie buffer conialns- a. leJiglh bfte. 
ToBuwCd bv an ASCII String rafwcscntinj; the palhnamr af iJic nctt 

p^mmeter oioic: Ihg word 
alzc and Vypffi word value 

nuise ot values^ SOMO-f CICXW 

TBflj boolean Rif^ in ^ l6-bn field. The bic^ are defined u follows: 



I 



14 

13-0 



Lf- ], plitc calUnj; pt-Q^mm's 
QWT ID nn reftjm iuck 

IT - 1, 'callina pognm msj- be 
rssUned frttm mcmqfy 



Chapla 12; FrwIrortmBnT Cos* 



liSfl 



Possible ProDOS 1 A Arrors 

OUIT ne^er resuins La ibc ealfef ThPTcforc, il CifinM remir in 
erroJ. However, odier parts oTPruDOS 16 may. E^ur e«amplc, L/m 
Intemplln* proBi^m (such as a dcst iD^ssJCsry} ianorcs csiabllstiisl 
caMTinUoru and u-ses a quit «11. e'fnr 307 (ProDOS n bLisy": 
miy occur. Fof fBngraJiuning nilcs tm-eri/lg such spcaaliTf d 
appliotlons. sec frograjnnisr'i tntroiiuf!U>n to the Appk !lGi 

If n nonfatal eirtx OKI315, cxcCiiuon passcs lo an imerath'^'c rauciflt 
thai al]iff*v3 ihe user la stltd snioihcr prag ram [o liiindi. Erron i\H 
may ouse ihui Indutle: 

$07 IWDOS ;?■ t3Li.'Fy 

J40 Invalid synui 

"546 file not rminJ 

i5C ^■'PC an ciccuiible file 

%^C Opetaling ars'^m ™^ available 

S5.E Cannw deaJlocate /RAM 

S^F Return .stadi ovt;f H'ow 

FaiiL effofs c?use ciGoitfon 10 lialt. Par eKamplcL If the Qui! ■caJl 
results in ihc luadlng nf a PraDOS S-bawd appliaBJon. and if itie 
syaUm disk Vita been illcrrd mih 1 differenl vereiofl i>f PtoEKJS fl 
Cnie PS'), it bs a fatal CffW (411). &ccu[ion TialK and ihc following 
message is ctlspliyed on the screen: ■ 

HtOPg OS versicn $0011 1 

lftl*p QUIT call results In the loiiJLng oF a PrnDQS 16-bas<d 
ip^iOitiori ihul i^ ton larp: 10 (It Ln the aviilatk raemo'y w ihai foe 
some wher rcawn afuioi be Inaded, esecuuon h^tlte and ihe 
MImvirg mcsMge l5 displayed dib iJie SCreCil; 

Can't run nwxt applicattoil. ^cvar-^XXXX 

where SXXXX Ls »n cnor code— Typically a Tnril LOCSKW, MtmoiT 

Manager, cr System Luader ermr code. 



17D 



Part IN Propos 16 svhbti CqII Raterencfl 



FdrUTnalsj d*Kr(plian 



i>rriai 



Lobol 



SOO-SOi 



vecaian 



GET_VERSION C$2A} 

Thi5 fiinrtiDn r-cfcims ttK VOiion nundjcr of Ihc (vrrentlK mntilra, 
PmDOS I6 Operating syslcm 

The iFrumcid vcxs^ofi (lumber is placed \n the version paramcicr 
r«ld E)o«h byic Rnd Ut values »rc sigjiJficaJU. Ii has thds forfflU; 






n Bjle a die mlACM- releaiu numltHr { = for PioTa'A i6 n^rsLon 1.03 
□ Byic J Is cite mapr rclca^ numbet ( - 1 (at PraDCS 16 version l.O) 
n B (ihe nuBt signinoilL bil of byte 13-0 for Tinal iFJeuK 

= 1 fat nil pfotoiypc idcuci 









Bvl 


B 1 




Bvl 


eO 






IS 


W 


13 


1? 


1l|lO 


9U 


7 ii |5 1^ 


ill 2 


1 





B 


Matoi ReJe^jse No, 


Mlri[:M' Ri^l^g^ No 



- re^jll 



Porarjiet^ block 



DMcripHon 



parajncicr nam«-; vrrsion 

slKf and typcj word resuli (hEjjh-DttleM byie »ero) 

raogfl or vdJuefi: JOOOfr^S FHhT 



'nie ^enlon. number of ProTXJS l6. 



Possible PraDO^ I6 errors 

SUf ProDOS to busy 




Chopter 13 



Interrupt Control Calls 



Chopter 12. Ei^virpnrrient Call* 
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These citls itlooie lAd dcallocaic Inicmipi handling, rtjinincs. 

The PiuDOS 16 ijuenvpf conirnl calls are ilescfilwd in ihe 
roi lowing dntcn 



KumtaH Funclton 



hiipo* 



$31 fti.Lac_iHiEftRUPT insalli! ^ Lniciiupi harnJler 

J32 DE»iil.OC_lNTERRiJPT femovcs an LuLcmipc handle 



^7A 



Port II: ProD05 16 Syit*fn Call Heterp™^B 



lnT_Fiijm 



- teiuir 



Inf code 



- poinrer 



ALLOC JHTERfiUPT [Sm 

Pframetef DIcKk 



ALLOCJNTEIHiUPT ($31) 

TJiis rurtoiun pjacca ibc addicM oE in intertup[- fiantHlriE rcucine 
inLa (he internjpi vecior lablt. Tuu atiouki make thta call berore 
enabl'rsg ihe 'hajdwarc that can ^ause &^ Jnierrupl. It t£ your 
fcsponsibility m make sure diai tlie couiliu: is Installed at ihe piapcf 
locaiitjn and ihat ii fallows ijirefmpi conveniiofi* fsee Chapicr 7). 

ITse cetumcJ int_mim Is j fifrer«rii;K numb^i for the handler. Its 

□nly use LS (o identify the hmdlcf when doiUtieating ill VOU mua. 
rcEcr lo x rauCine bjr ||5 interrupt I'camller number la Tcmove j[ from 

the system (with dealloc_ihtehrupt) 

■Wihen PltjDOS li£ jmelves an intctrupl, IJ polls the iBSialletl 
ha^ridlers In seqtieilrt'i according to their order In the Inierrvipi 
vSCTOi lablt Ttic firsl hiadl^t irtsuHed fas the ["li^ghcal prioiily. 
Each new tij ndler iiutallcd u adJcd lo Li>c end of ihe MbJei each 
orte dcallDcatcd [» remijved from the list and tlie tabic is 
compacted, 

* Nofe Under ProDos 8, the [ntcfmpr hiifldlec number Is chjuiI 
la the handler's poaition In ttic pulLLng snjuencc. By totitiast, 
ihe value of int^nurr under ProDOS l6 is uanslited to the 
MCfcr in which hwdkn iK pOlJCit 



Chopt'Or 13:'lnrsrrypiTCanirat Colli 



1?fi 



PnramaiAr d«KrlpHen 



IflMI 



SM-SOl 



S02-W5 



inc. num 



l_nt eode- 



I 



DMOrtptiwi 



pafamctrr ndiine: incciTUipl ttandlec number 

siitt and type wonl aauU ChLjih-oirdrt byre M!'n3 

The iiicsi!iify\(\g riLtmticr assigned to ihe iiuenupi handler by 
ProDOS 1^. 

pafometef oania inierrupA code 

sIec anil lyp*: JanJ! waid puinB" ■CttLgh-anfcf byte TSro} 

rmge of t^uts; AfloOO iXtTifl-SfflF? ITPF 

The Lcsng u-ord iddiess of the intomipc handler routine. 



Pos&fbte ProPOS l* errors 

SOI PeoDOli is bjsy 

SZ5 ]nlecFVip( vcclnr tabli: ful] 

3;3 Invalid pKanWKf 



T7a 



Part IN ProDOS 16 SYslem Call RBtaranca 



DEALLOC.INTERRUPT ($32) 

UlU Turir^nn dears ihc cnlry (spedDed by fn(_*llflW) fflr an 
inlcrmpt hindlcr frocn [he in[«iupt vcctot tabic. 



Importon! 



taatiatlai dmcTfpllon 



OHt>i 



Ldm 



JDO-SO] 



Vau rTn«t tSwblo rtw OMOcSaled Internet fwrdivare cerar« 
m(S<ina tivt caU. A tatal wfor will rewjr If □ tiordware Htmriet 
occurs affar Its eniry has b««> clecrad ffDm the vector tabl», 

DEALLQC_IMTEEtpUf T has na effcd on ihi; <ai^r of [he polling 

sequence for [be rcmaJning handlers Any subsequently allocaicd 
handlers will be added m [he erid of the p^lii^ seqiiefice. 



- voig* 



DUltOCtNTEHRUFT ($.]£} 



DaKNpiian 



int_fLuin pBr?ji)et«r uuiic^ Lntccrgpt haridlei number 

slic Bod iypci -wDcd voltjc fhiflhorder byw icri^ 

none at vjUlMS; ^DOO-iOCM- 

Tbc idcntir^'lng rumber Asstgncd to the Enremipc hsndlcr by 



PostB^le ProDOS lA Airors 



i07 
S5i 



PcoDOS ii busy 
invalid p^rtmeter 



Cl-ioprw 13:1nl«mjpt Control Ccrila 
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Part 



The System Loader 



1fl]p System loadci u m Apple HGS Loot sd lha.t works ckmEy with 
PioDOS ti^. 1'[ ii- i«vpcinsibt^ for ItacLrk^ all piruemn <:aiie md daia 
inm ihc Apple Ilos mcmon' tt is oipahLis of sucic ind dynamic 
IfHdJng ami RflHDciU'ng of cade and liala scgmf nEs, sulnroutln^, 
■fid Mbnrles. 

Chuplcr H cxplaiiiu in ^ncn] Icn^ tiuw Ihc Syslcm. Lcndci 'wniks. 
Chapter !?■ d«aJk some af tu TjEicLiuns and data straaures- Ct»sp[Er 
15 ((Lves prnpammins iuguwiiuns frjr using ihe .^ysLcm Loarki. 
Cha.picr 1 7 ^shows tion' La make- Loader cailA and lic-^fd'L'be.'; eact) caEL 
Ln deuli Sec Appendix I; fat i ^ompitUi \al of KyStrm Loac^r crmr 
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Chapter 14 

Introduction to 
the System Loader 



lai 



This. Chapter flives a basac plOure of ihc Sj^stein Loadfij-. defircs 
iOnie of the lmpoitan[ rerjiw needed lO fWplain wJdl the loader 
docs, dcscribta its interarriaiis -ivith the HemDry Manascf,. i"'' 
pnEcnm 3fi nutliric of [he proraduica 11 roLlowj when loading a 
progfani iiam roemory, AddiiianaJ related icnna ate fisfined in i.t« 
Clcsaary. 



Whcil Is Ihe System Loader? 

The Systsm Loadn- i* a set nf software routkws ihal mirtage! ihc 
loadljiB of program KflmcnU inlO the Apph; 0G5. Il is an Apple tIGi 
loaL Ml; as iuth, il is independcni: of PrnDOS l6. HnwrvTir, ii wofta 
very tioacJy with ProDOS IS and with [!"»« HemcM-y MlniHef, 
another (ool sel- The Syslcm Loader has several ircipfovcmEnLs OVW 
Ihe loadiriB methcnd under PrtjDOS B dTl ottsej Apple II compuiois: 
n Ii makes londinjj casicF and ffiore convenieni. Under PiuDOS 8, 
the tHiJv auiomatic loidiniR Ls pctfnimed hy the baai code, ■whkh 
searches [h« bocn disk for [he lic^ system file (lype SFF> and 
lonis il ecLtn locatian 42ftil> tf i sj'slcm pro^affl twcds lo CdU 
«nD[hei applicailfin it musl da all [he wort LLscIf, eitlriET by 
HiakiJig PmDOS a calls ur by ppovLtiLrLA J-i* own Lcudci- On [tie 
Apple DGl, calls [t> ifie Sysiem Loader perfurm ihe Uik muse 
s Imply, 
n K is J relKaittig laadsr. ii loatlii r!jk'citii>]G ptoBiams si any 
jifailjblc loiLaLiOrt in memory- Under Fio[X>S B, a prajjraui must 
be losdcd it a fixed memofy addieaa. or at at* address spcdHe-d 
by the S^wem pioarirn [Jial Joes iW loatUng. Tlic reloiitifiB 
loader rclievas [he piOBcammcr cf [he burden tand rtatricilon:! 
or deciding where cu luid prcRrams. 

C U Ls a senrni-rtt tosder- u cjin load difleEeoi segmcnls of B 
program lrdijpc«idcn[E>', la use m^jnoiry efficiemlv. 

n tt Ii » *f>miin«c foflifcp n can lead ccnain proeiam scgracnis li 
Lhcy ue needed during eieculion, either ihin al boot tlxne uniy. 
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TTie Sji'sicrn Loader hanijles (lies gEneratcd bj' the APW linkei^, ihp 
linker hindfes fites produced hy an. Apple Lies asscmhltor ijr 
Compiler. The linltist, a.wicmblcr, and. compUeii are part of the 
Apple ncs tPntgranuacr's Workshop CAPW), a powerful and 
flexible set t:f development pro^ams designed itj ftelp 
profjammen prOduicc Apple Uas. a pplitaiLians cfljdently jnd 
ooflverucntly. See Chipiet 6 nf tlus manual for more Infotination 
M»d ref«f«niss an Apple IIOS Prusmnmcr's WwlullQp. 



Loader termlTiologY 

The System Loader b a praEfam that pro«3Sca ktaii, Blcs. Load files 
MP PwDOS l6 applJcalJofls ot t3[hcr Types tif program files. IhE^ 
Contain raachJue-llESguagc code or dais Jntl musl follow dbjea 
mfxfule FoniLat (OMF) 'ipe.ciEica[iDtis, a-: dcllfied Irt ihe ^pie ACT 
PKgrarnmeri \fw±sftop fle/ereHCfi Hath load file .cQn5^st! of lo«l 
H^menu ihai ca^ he load^ jiuo memory indepentknilr. 

Lnad segments ran he ei[|>er Bt^c or dyjuiQijc. A program'^ .surlc 
it;Bmenil5 are [Ciadcd into memory at initial load! tdrr« (whej% die 
pfOgfSfn ia Tint .^artofi u.pj^ [hey must slay in mennory umil ihe 
prnjjram is complete. Dyjiamic load sesmettK, an the othtr hand, 
are nt* p4iir«d in memtiiy it iniiial load ilmc; the)- are loaded as 
needed thirina ptiygtim encecutinn. nynarttit JoadLng can be 
auiomalic £:[hn!>ugh the Jnicp Table) or minLij] Cat L^le specifjiC 
request of the applicition thtouBh System Loader ftjncrJod call^. 
When a dynamic segmcnl 1.1 rwj lungeF necdod b>' the pro^jram that 
called It. il cnn be pnrged, ui deleted, by ihc Memory Mansger. 

Segrrants Can be absaJufe. relCKBlable, ai posklon- 
Jctdcpciidcnit. .Sm absuiiite sc^ieni muM be loaded Imo a spccifn: 
Incation in tticmorv, or it -mil nnt fiijietjon prapedy. A ceEocitabIc 
lesmcni can erectuiir cnrreoly tarhcievci the Sv»«ni Loadei places 
II. L*aii jcsirirted of ill is a pi>?i!ion independent segment; its 
functioning Ls loully un^Jfecicd by lis IncaMOfl in memory. ]t can 
even be mnv&ct from one location 10 inulher between eiecuUons. 
Most Apple tlCi code is relocatable, but not posftion-iiittepeodenL 
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Loid flies on conuiJn segments orvaffous Wnds. Soii'e seaments 
cciuial p-f proKcam code cif data.; others pjnvidic locaUoji 
ln,fofTnflilon [o the loader, 'ETie Jump TabJe se^mvnt, when 
Loaded imc jnemDiy, piorldcs a, mcchanKm. by which jc-^mcnu in 
memofv on ifigge^ the Loading of lyihet needed segmenis, Each 
load file cin have anty one: Jump Tabic scgjimnL A iGad Els can 
also have one »e^en[ railed [he rftiJuuuae s«gaieni, nhicti 
providics a onss-rcfrrtncc between, file numbera On ihc lump TSbte 
segmemij and pailinaTncs <»n disk) vf J^Tismk segmifniiL? A. ihud 
apcdal lypc of segment U Oic \aitlaiixaiiua srgiaail. [I ccnIiJiLl 
iny code thia,t haji in be execuied Rrs, ixiam: lite ri^ af ihe 
scgmenis are loaded. 

When [he Sy:iEm Loader lis tailed to load a prcgram, JL loads i.[] 
nuUc ]oad se^fnenu including tlie Jump Table segment snd rhc 
Palhnarnc segment. The Jump Table and the Pathname Table 3ir: 
COCSiruttrtJ frum ihcae !*■□■ scgmcnLs, jcspccUvdy. During lliij 
procca, a Memory Segment Tafilic 1:^ ^^Q fon^lcucui-d Ln 
meroory. TL>«5e ihree laUtii. aic discuKsetl in mDit deiall in die my* 
cKsipter, 

A ajnticDlng pEaj^rarn. Eii i pro^nin ih9.l reqiwit.') [hij Sy^tcin Ln^da 
to peffonn an Initial lOdd an inalfacj" m^jor pHjigiB.m, usunLly in. 
ippjiuiCicin. Ihc Uicr ID htaaajfer sa^ign.^ a, uniqv? ld¥nunL:a.l:]an 
number fUsar ID) lu iliii applitaiian, sa the L^ndcf may qujcfcly 
IcKaic all or ihe spplioiiofl's segment iT necessary. A sv^nidier Is m 
exampLe nf t ccmtnoJIins pfOgram, PnjDOS 16 ind ihc APW SlicIL 
ise ilsa cun^jolLLng pidgiams. A wcini prtKessot te an exsn^ple or 
an appll«:U|on. 



Interface with the Memory Manage 

Ihe System Loader and the Meinary Mai\a,g£r wnrJi dntcly [aaciher. 

"lie MemoFV Miaaaef U ^n Ap^le IK ibbI sei [riFrnware pRtjErain) 

that Is IfSpLiaSible foe lUomirig memory in ihc Apple l[l.;s. II 
presides spaa few Jrad .ugmenU, telLs the S^siem loadef ^liere lo 
plil.C£ [hem, »ild moves icgrncnla around, within memnry wtien 
additLooal space Is needwL 
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When [he SjTlcm Loader toads l pfOgrtm stgmcnC, il ealEs [he 
Memnf^' Msinj^gci to allocate a cqiriespondJfUJ. iBeautry blocL 
Mcrraory bbdt* h^vs attHbiuUB ihaL air dosely iciticii lo The laid 
aegmenu in ihem. 1/ the pnojjram .wgnnefli is jjanc. Us memory 
b\ack is ntarked u luipurgeabk ijneanin[; ihit jts coaisna cuuioi 
5sj eJ^sed> and Bxed (meaning thsr in JMisidijn cannot be 
dianjscd). an lon^ aa ihc program is niEuiing, ]f ^e prugram 
segmtnl ij cJynamK, IM metnofy Uuck is initially msij-ked »S 
purg^able IxjI Itjckcd <iEmpnrarJlv unpurgeaWc and fisted; suhjea 
[o thinge during emsfuttwn uf the pragranO. If the dynamic 
^cRmiTu is iAXltUm-tndependsfU, ii9 memoty Ma<!b b mailfcd m 
■nuvabic-. adietwl'^, it Is Tixed. 

To unJoOiI a scjjmcnt, Uie System Loader calls ihe Mcmtwy 
Managcf lo iitak« l}»c coreapondJng memofy bLciCk puigcablc. If itic 
oafiliCillma program wijjies lo uilliiid O/l segments a««:UllJSd "i'lth I 
partnTiilaf appliciiion ([□! exampU:, k shutdtJwn). it calls ihe 
5^s[em Loitkj's User Sliuidown function, which in turn caJls the 
^teJntlf>■ Manager lo purge ihc appUcailwi's memory hbcks. 

To speed, up eneculion of a finrlcr or switchec thilt filly rtccd to 
rapJdly reload ahut-down ipplicarjory, the User Shutdown functinn 
tan optianaJly pui an application mlo i donnan; aate IJie loactet 
calts the Memory Manager to pur^ (he application's dynamic 
ae^cnls, and mj.kf. M sliJlk frgmcnls pgrgcable. This process 
frees spiM but keeps the unloaded sppUcatior's cwcntial segments 
in mcmoty. tfthwever. If for any reason memory runs oul and the 
Wercitiry Ma.n3ger is fofced to pur^ one nf Lhnnc ^tiiii; segmenLs., 
tll3i[ ipplicition can n-a lunger be u5ed=M.he nesi time it is needed, 
it miiSt be baded from its disk file, Sec "User Shijuitpun' and 
'Itestaff [fi CliSpCcr 17. 

• .^'uie- Strrcrly speaking, load segm^nis are never pwfjffd oj- 
locked; those are 3clions laJten uti :he mrmory blofics that hold 
the ^gments. For simplicity, however, this mant»j| may in 
CEilain cases apply [crrrts such 3.5 putged oi lucked to ^e^nviAs. 

A tsfpicil iMd sefiflient wU] be plawd U\ s raeinoty block that is 

LofliPd 

Fiicd 

Puige Lci'cl - Of die segmetu Is static) 

Pu[ge tev«l " 3 (if Ihc segmera 1^ dynamic} 
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Dcp<^ndinE nn oihtt «qu(femeRE5 ihe scgmcni may liave^ such as 
aJignmefii: ifi men*nry, the Inad scgnieni meinoiy block 
relaijtmship may be mcwe CfimplciiL Tabic 14-I sfiewS al] possible 
Tclalioiwhips betwccji ibc Iwd Uiil msy Hold at load time. The 
rfLrect-iHBei'siack segmedl tias spcoal drurtoeristlca descrttwrf m 
ClapTfir 6, 
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Loaa-Bagmanl/marrwrv-block rel^Sarrshlpfi £qT Joaa Itme) 



Lead Saginvnl htlrlbulB 



fi1«morr 1Ick:]i AHirbuU 



stadc 



dyciaraJ-c 

ibsciluK (ORG > C» 

reim^Lible 

posiLiofl-intlepenfii^ni 
not pE)^icin-[ndcp)ciideft[ 

KINO " Jn 

BMIKSIZE - 

BANKsizE, '^ sia {Kn 

ALIGN -^ n 

ALIGN - tionoo 

dlrea-paae^stadr Ckthd = 



S12> 



unpur^ablc, Q^^d 

Ct]ftitiovat>te> 

pu [({cable, lockod 

fixed itidKis 

<j\a spedAc rdatiijn) 

nnt fined <mcvftWe> 

fjlfed- [urmavatalcj 

[uc-cd-biok 

may cross bank faoundijy 

may nol cjtj&i baxak bourxUri' 

fiol bank' ur pa^e-alifiiicd" 

pige-aUgrKidi 

b^nk-aligned^ 

purjseable, -nxed-banlc ttOCd, 

psBe-alLgncri 

■fAilanmcnc mi/ alao be mntroMed by ibc value in ihc BAMKSI2E 
field—see Appendix D. 

* Nffle: ORG, KINJ', HANKSllE and TiHGM arc segmenL 
hcidcr fields. deStnbfid in ApftcndiK D of this manual ami 
under 'Ob^c^ Mndjle Poimai" Irt Apple tkrS PmgratnmeVs 
Vgi^AL^ Rejtnertce. 

A memoo' bLncli can te pjrged through a call Id the System Laadet. 
bul nthcr anribulty Clin he dumped only ihrouEli i^Jcmorj' MsJiager 
calls. Menvorv bl«Jt pmpcniH useful lo an apptiralinn truy 
iiidude 

□ Sun locacian 

n User ID Cidecitillfcs die ap^citlon the block is pan tfD 
D Purae lei.'el ffl lo 3: - onptugnablc, 3 - mi^L pujaeibLe) 
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ThcM propcfties may be accessed cither Uimiigh the Memory 
Sc^tncni Tabic (sec Chapter 1^), nr ihrouRh the Wock's mcmqry 
handle, which is pan or die HcmOiy Stamcnt Tabic. If die mtzmoin/' 
handle Js NIL {poijiU ta a null polnc^], |hi> ni$UTL<;/y block tuii besn 
pyjjed 



Loading a relocatqbl^ segmenf 

The loUowLtij! hrjcS' dcsoiption oj" paiK I'lf Mnt ojiertiiGrt of the 
SjJSiTeAt |j>adcr aho-v^ Ifdw the Ijnhcr. loatfcr, and Memory Minager 
wark tnjtcthcr (n pfodm:^ and lead a ralDi-icable pras^m jajgiucUL 
E'i^rt 14-1 iJi3.£j3TTL'; tb>c proce^; in a jiimpltFi^d Tcim. 



Lood-flle stiucture 

Load liles cciatuim to a sub^ci of t^bicci uiikIuIc J'orjn:^! (OMF). In 
OMF, each module (file) consiSB ctf one oc mure scflmcnis; cadi 
Hgment Is hicdicr made up of one Of more recoflb. In a load file 
Rpud n i,^lly, eiach iegmcnt 'Capan Tcom, Epcdalizcd scj^mcnLs ^ucJi as 
the load Hk ublci: dcKribed in Chapter 1^] cornisis aTa leader 
foDowfid by pfOgram Code nr da.ta. in turn foilciwcd ijS the segnwtnt 
is TeJocjlableJ by 3 relocalton dJctlOUary. The iclacalinn 
dJoiOnaiy is created by Mai ilnkei s.s \\ cdowei;! an obccl KBrncnt 
inlo a leid vcBmRm., 'Wn pnJgram code or data cortEtsts cf fWD ivpca 
oT reefnd* L-COKST recot^, which bold a][ code jnd daU, ami ns 
rw-'ordi, used for filllrig space wllh wros. ThK tCldCalJon dictiariaiy 
consL^L.'i ol" IWHJ general types af records: reuji; recfwds, which 
give the loadrr the in/ormiiion \\ t\{^;6s lu rraolve lool 
Onirascsmentl i*fci£ntt^, and INTERSEG rccnidj, which give 
Ihe loader (he inftwmaticin li cweds TO rtMCitve cxIcitu.1 
(inlersegmcniJ iefcrefli.'cs. cBELOC, cIWTERSEG. and SUPER 
recoidi itc aLci ftnind In naltjc^ili^ji dlciiururlRa — they are 
ajmprEswd versions ijJ" HtiLOC and IHTER&EG fctxirda. The 
dcliiiled Fcinnais of aU OMF recwds in: presented In Appl^ UCS 
ProjiTammsr'f \X'or!lshop Fs/iT^nce. 

"When a ^cl^>catahic iegmenr is luidcd intn memnry, it is placed at * 
location deiermjncd by the M^jmofy Mlrtagfir. [■urthetmufc, unly 
die Jii}i< pid cif [lie segment (the ptngram code liselO Is loaded into 
die part of mc-jntMv ic.F^rv^d by [he Memofy Manager, the 
rclo^aiinn JkHunaiy, if present, is loaded into a. buffer or wurk areai 
used by the Inadiif. Aftef loadii^g the segment, die |o?def reliKMa 
li, usi]i£ the inConnatiDn in. die ielC)Ca,[jCii^ itLLii^^r^ary. 
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LMdlng a retocatatte aegmant 



Relocation 

Aficr ilwr Syaieim Ijiider ha3 pkeed a inid seamcm in Txicmory, it 
nrust (.unSrss Ihr; ScpnieTil LurWiStS Df ibsoJliie COde> Mtcicaw Ik 
addfCM rcfcdcncca. RcSocalJOni tfcscntics ihe pnW^^iSifig rtfil Inatl 
»egmf^i .«o iliil li nil! execute pinpciLy ai Lhc mcunpt^ JocatiiLiri a.i 
whicJi il tis5 tx^n iMtlcd. it ojrlSisLs (jF pflictklng (MJh.5U[uCtnft Uie 
proper values faO a-ttdrcss npcrands Ltial refer la InfsliOilS boltl 
WLLhin inii txKiiH\ lO the Mfimenl- The r*!incitjaii dictiDnaiy pari 
oT llie icgmcnl c:ant3ins ill Ihc Jnfonnaliun nce-[Jcd bv Ihi? Icillder fo 
tlu ihi& paidiing. KeloatLon u peiforrnwl as rijUtjw*: 

I . Lucal K:feiCrtcei <« TJw lead segm&nl Ccndcd ir the nriElnal 
qb|nd trie as oHkcu from [he bcgiiirting uFihc segmeoO are 
paichcd rnsm PELOC recoftls in the Belocallon tliclinrary. 
U&Ui£ iiie ^U-rlimjt 3(14rc» af tin: scgmcnl -C^t-'ailiblc frum lllc 
MemDry Minaeci LhrDugh ihe Mcmury SegnKHi 1'*ble), ihe 
loader idiJs ihai addrew lo tacts offset, so thai the cancel 
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2 EKtpina! rcfcrcncfcs irtFtrtn^fs to oihef aegmentsj are coded la 
ihc uriginil obieCL module M global variables tsiibrnullnc AUnex 
ijr flntty p™iU.s>. The linlicr ind fciadej- hlfldk ihem iS foUowg: 

a. If Uie ncfcirnce is [□ a SLitiC se^niejll, the /IwJfe^wLU have 
dLail:i.tcd the pFciiKr itlc number,, scgjncnl number, ilfld 
uffsci of ihc rtrefeneedi (eatftmaD segment, ajvi placed thai 
information in in IHTEBSEG fCCOfd In The fSiOCaxLaa 
Jl'Ciionary. When ihe lojd segment \s loarted, the twiddTiiBes 
the Il^TERSEC; [ci(nrd and the mcixLCiry locBlIoii 0[ ihiC 
cACemaJ scsmcnt (milabjc Ciom Jie Memory Minagi&J' 
[hfau.3.11 [he MefflQfv 5e.gmefii ra.blc), aikd ihcn paidies ihe 
citcmal irfrirrcc mth ihc proper memory addiess qF ilie 

i>, \I ihc icfej^sicc [s ttj a. dyiuxuic scgcnciit, the llriltsrwiii tuve 
cTHied 3 gljgtitly cliCTetertL IIJTERSEG recoid: iivit^d at 
;eJ^>efieocing the rile number, scgmcnL and aSsci ni the 

Trfeirrtced cifltmal scgmertt iLwlf, ihe INTBRSEG lecoid 
reJererces ihe flle nynhCJ'i segment number, and oEFsd of an 
entry in Ihc Jcimft Table. Thcj'eftjrc, when the 9oad Moment is 
loadeil, [he to«fcrpi[clie» the E-Brerenc* to poinl to ihs Ju.mp 
Tjbki entry. Tlct entry, in turn, [5 what transfers eonlia] It? the 
exi^cTu] segment ai it^ proper nKiiiury atJtlress (if and wheti 
itie rtfeceneed .'iegnieni 'a loacled]. 

'lite jump Tible atid ilie reasons Tot; this tndii^cl reJerercing ar<; 
dcscfibcd Eurihec In Chapter 15. The flialn poJni of interesL here 
is ihaL, wli^^n it performs rclDcatiOn. 'ihc Load^ il£i«!Si1'[ taffi 
■whcthnr an LnleHj^j(nT*nl: referenoe is to a slatic nr In a dynamic 
MfgmtFLl— it [icAU buCh in c:(ia£f The iunt: vly. 

The SviteED) Lader perCotms septal ocher fuiiaions when it Iwis 
dynijmic se^nsmL^, indudin^ fiQa.rchln^ fur (he name of ihc 
segment in (he Pathname Table b«fnic badirB. and patcihing die 
appropitate Jump Table emry afr^nvard ThcM: and ntber funoinns 
acr dtsmbcd in more dttatl in the ncict two chipltrs. 
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System Loader Data Tables 
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Memory Sgament Tobla enlrv 



This chapter descQws the dais Ublcs icL up in memory duiin^ > 
I01.1J, !□ pravLdc crai»-icfercj10c iiltanxiiLii^ri [0 ihc lOJCter. The 
Mernorj- Segmeni TabSe allows the lo^dei 10 l<eep tratk of which 
asgmewits ttivc been loidcd. and where ihey are in manorf. the 
juiup Table i\]tj--ws pcugnntis id rererenoe (ouEiines In dynncnli: 
.sfijjfnciiB Ihat may ruii oincntly be in tnemafy. The Pathnime 
Tabic provides a crOM-reFefftnes berweert file nurnbefs irnJ llle 
paihrurties of dynimtc segirwnlS, Th*^ Mark List speeds iclnation 
by keeping IxaLk oT rclDcilion dictiQEiAiici. 



I 



Memory Segment TabEe 

T^ Mernofy Se^m^t Tublc is 1 ]inki;d ItAt, ca.ch 1:1111)' of which 
describes i. maiKsy block kni^wn 10 [he SyBiem Luader Memnry 
bic<c1u as a.Lli>[:itcd hy ihc Mcmnf>' Mana.f^r dunng iDsding oi 
sfgrnrrils Etciiti a load, file, and, csrh Liliufik to-rriMpurVl^ I^ i Sin^gii?' 
iQad se^nieniL I'Jgure IS-l jhDkvs ihe fomut oT eidi entfy In Ihe 
Memory Segn^nt T?We. 

The TielcU have ihe fplEi^wing cEteaningj; 

Hand* to mxi •nUryr Tt>e ms moiy KardJc dF the neitt cnuy In ths 
^fcmll^^y Stgrncni Tabic Tliia mirnlM^r u <] For ibf lAi! tnuy. 

Hofldl* lO' pf»VlDUt »ntry^ The mcmary hiiidlc of [be picviOuI 
entry In ihs Memoiy -Segment Table. Tbiis niunber is For [he finji; 
entiy, 

Uwr It: The idcnUfLcalinn number a^sign^ Id 1^ memory blilClE 
[hi-? ae^ieni fntijWcs, Nocmally, the Llsst ][> Js available -dircislK 
ficm iJtc Memory Managci Lhrough ihc memory handle Hij^-cvet. 
[f [he b'Klr has- bwn piwged 1(5 haJxUe is NIL irid \hti User ID miisi 
be K=ni (mm ihil Tieli 
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M^moiv hondta; Tbe ideniifytng lumbcr frf ihs memdrr hlock, 
tshuineii fruiri ihc Mcmnfy Mjfng*i. Addititwial memoTf blodi 
LnTurmaiipMi is available [hji^ugh thia hjindte- This handJc is laL if 
■tflft blOtSt ha3 bfcn purged. 

UMd-fllo rw*Tib«K Tlsr mindwr of Ibe loitl Rlc from wbldi Ihe 
scgmcni iira.s nbujoed [f ihe scsmcnt 15 in Ihe Lniiia] load fitc, the. 
rumbec [£ 1. 

U>od-**giTi«nl' fiunfawr: The segmtni number of ttte segnsfni in ihe 

L«»d'fc»gmBnl fclnij: The uahic of tW K1H& Geld in the 1 01 {i 
se^sem'i hcidcj. ScRmern lilnds ait dcaciibed In j^ppciidic D. 



Jump Tabl0 

^■1*611 3 pcugram fload ffle]) if Dnilially loartd, orily the ilatfi: Joad 
SCB'''^^l* 3i* plained an nujjiioty; It ihdl poM ihe System Loider 
has a(L Ihc inrctrmiticii ii needs. Lo r^fiolve ilEI symbolic refcrefWES 
Ifflon^ [hem. Umil a dyr»jtut Scgmcnl is Iciaded, huswever, the 
loader camnoi WKJi^: icfcrrcnccj «> it because it does noC lirww 
n^<iKt id memory il wQI be, TbiLiS atalic sefunenu may be idiicaty 
mfcicnccd Q}y Bach oihcr a.nd b^ dynamic .segments^, bui dynamic 
aegmcnB can be rererrnced only tfirou^l JSL (Jump to SubmuLiEic 
Long) ctl.li [n Ihc Jump Table. This scLlion ^teiicribes how that 
fflechaiusm worlcii 

The Jump Tibtc is a. stnusUK dial iSittws a pfoyarti lu irfcrcncc 

dynamjc srjjmcnu. U cunsisis of ihe Jump Tablt Ditcctory and one 
□r more Ju-friji Tabic scRmenis. 

On djsk, Jump 'laWe segments an lead scgmenls (or kind S02), 
"cawd by [he Linlte/ to resolve icfcrencej tt> dynimic scRmenH 
Any Joad tile Of nin-[ime libr^fy file may oint^Ln s Jump Tabic 



111 inemcry, rht Juffip TaMe Directory Is cieaied by ihc loader aa It 

(Old! jLimp Tible seBmervi^. TJie jump Table Diicctnry is 1 linked 
lial^ cadi entry at whidi poinls Vj a sin^ Juntp Tf,bie j«g,ment 
encuunu:;^ by ihe loadej. Figure 15-2 show^ the Eaimii □( an entry 
In 1^ Jump Tabic Diiraiciy. 
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preulcus B^lr^ 
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Jumc Tobta Diroctofv enHv 

1^ l^elds tuvB [he fulJcwing meaning: 

Hmdl • hi iwi! wihv: The raemofy handlt of ihe nexi enitry in ihe 
Jjmp Tsble Direciofy 'fhi* niiniber is Cat [he lasi enuy. 

HcPHidl* lO p««wlwii i»irvtf¥: The mcmocy handle tif the prc^idui 
lc^u■^' In the Jump 't%b\^ Direwofy. Tills nHmber is for the Fitw 
erirv. 

UtM ID: The LdcnlifiLaEian numtwi assigned lo the Jump Table 
segnicitt that ihLs Dircctary cntr,' tcftre to. 

Mkinwy hondl*; TTic handle ni Lhc memory blodi cnrHairtinS [lie 
Jump Table scjyneni that (his Directory entry rcTiCis tP- 

Uke the DirrdQiy, lhc Individual Jump Table- scgmcnU cimsial of i, 
»eiie& of eraries. The neKi Ihnse stibsecijens desmbe Ihe ctealltm, 
loading, and use u( a single Jump Table seffmenS entry. Tbe entry 1: 
used to resolve a single JSL jnuiuctiotii in a piugmm WKttienL 

* Naif Th^auglitiui \hn manual, Llie lerm juiop 'table emry 
refers Id a Jump Table SB^ment erlry. nnl a Jump Talkie 
tHrtiKfy cnlry. 



Chapter 1G: Syttem LsqUk DoIq Tdbles 
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CmoMon OS o Jump Table enlrv 

Vw Jump Tihlfi lotd scgnw^nt li creaied by the Unkf^r, as [be linlKf 
prcccracA. an ubicfi (ifc. F-sdi liinc the Unhsf encaixmci^ a jel lo 
i rOkiUnc Lti an ewenjil dynamn: segmeni, it (reaies an rWTERSEG 
record la Ihc irtncilintt dirtitmary {vF iIb bad ECjimens, and fif it 
has no! dnne ao iLrcidy) an entry for That (OUtitte in ihc Jump TjUc 
spftmeni. Tlic ihtekseg record I Inks the usr. to iJic Jump Table 
cnuy l3iw wia Mt cJBUed Flguic 15-3-5h!jws thcrtHiml of (Jie Jump 
Table entry [hat ihc linker creices. Sec ifcu ^^iton a u( riRurf; t5-* 



■ Icwau 5egmprir no. - 



iJaarCi 



lo&ctlle rx> 



laa^J-jeamai' 



JSLta 

Jumfi TmCte Loocl 
rurtlun 



JBvtM 
? t;viJ3t 



FlQura IS -J 

Jump Tobta BTifrv funlooded Bic+») 

Tilt: ficltEs ^ave ihc fodowins meindfij^ 

llM' 10: TTiE- L'-Scr ID ofiht rtfcirncccl dyJlinJi: ferment. 

Load-til* numbw; TJi^ load-fite number of the rcfeicjiced djTUinic 

LAaa-i«gm*ni fiijtnbmi Tlie ]aad-ReBmen[ number oF the 

referenced dvnjtnjc scEcticni. 

L«id-»flm»nt 0tr»il: The locjiiofl rf ihc referencHf aiadrcfis wiLhin 

thi? rurfcrtmtBii jjynamic se|frr»KnlL 

J!L lt> Juiinp rabi* lAaa fun-cllofi^ a long sLibroutira; fjmp to Lhc 
Jump Tabic Ujad tunmon. The Jump Tabic Load rjndtinn h 
described in Oiaptcr 17. 

Tbc finjl itaiy in b Jump Tatite segmtnl hi* a lOad-IJJc number nf 
lef.o, In JndicaiB ihat tluin; arc rwi mcsre entrJea in th>e segmenL 



ModHlciTtion at load timft 

Ai LiJad lime, ibc Ujiids^f plaocs tSc prtigrim .lejiment and [he Jump 
Table .5e,SLmgnt inttj memOfV Cil doc5 rvcL yet lusd rtic tftFcrenced 
dynamic SCfF^wnl|^ To Link ihc Jump Table segment with irty other 
Jump TatitescBmentiJtmsv hive iKJEicd.iUMlKS Che Jump Tabfc 
Directory, The Jump TaWe bi now complete 

Using Tit irirofma.[inn in the IMTERSEG rccnrd, Lhc ICHdet 

pilches tfw JSii insuuoion Ifvihc program wjjmeiit s" thit it 
r^Fcicncea the proper pan of [he Jimip Table Ifi mcmary. t[ also 
patches [l>e y-CTLial address af the Jump Tgtale Lnad funrtlon into the 
Jump Table cntiy. Tlie Jump TaHc entry is liow in lis untoaiiftcf 
jjflfe, 5ee setiitm A of Figuic 15-!i. 



Use during e^ecuflon 

Dmrififi prnflnm execution, when lhc jSl insmiciion irt lhc 
orij^iniii load segilieni "5 encnurtered, lhc following sequence uf 
evenly tiLl<«» piacc: i 

I CnrltKil [fiUufeK CQ the proper Jump Tat^@ entry. I 

3 , The JSl in ihe erttiy transfers ranirol to tix System loadei's 

Jump Table l/jad Tunaion. 
3, The Jump Table Load funfiion ([ct5 ihc lead-flie nufnber, ]oid- 
Kgin«m numbc-j^, ind Load-segTrtern 0(fTsct of the dynamic 
segcncnL from ihe Jump Tabic entry. Then i[ gMi the liic 
pAthnLtnc nf the dynamin: segment From Uic Paihnime Tible 

i . The Sy.5tcm Leader loidi itie dyrumit: scsment iniu memoEy. 

5. The loader thatiee* the dynamic segment's erwiy In the Jtimp 
Tabic tO' Lis loatied siate. Ttie li^adetl &l3t« t^ idontkal id the 
unloaded stale. ei:«pc Itilt the JSL lo iJie Jump TabJe |.0»d 
fuin-iion LS lepUocd 1^ a Jwl tuOMi^diiiOdal jump LansO lu the 
citcma] n:rc[cntc itself FiftuJe 15-* shows the formal I\l« [he 
loailed sow. 
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^. The loidei Iran^fets ¥i>nHT3l lo ihe dynicnlc BCsmenL When the 
n«w segmenc has Tinishcd its Eash 'Ctyp[(al]y Ii Js a subrouucK and. 
eri[B with an aTL, Retum ff om SubiOuLiir Long), rontrol 
J£!&jms lo thc^ 5[alrrnfnt fcQawmg |hc origin?] JS-L ilumjaJDn. 
Sac scdinn D nl Figure ]S-5, 
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Jump Tobto diagram 

Figupe 13-6 L5 a slmpUJcddJaBnin ofhow [he Jump Tabtwaiks, It 
Teillrin^ the CTtittpn, losdlng, and use of i sina^e J^J^P Tabk entiy, 
aemif/i lo tesolvc a sLn^ mstrgftlon in Eoa(J scKnicnc n. The 
utetmcu'on is a JSL to 1 SLibrDuiinc nanMsd r^uHne In dynunlc 
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How iriB Jump Table worfu (cDntlnusd) 



Pothnam^ Tabte 

The Piihnamc TalWc piovjd&s 3. cTOK-refe fence between file 
numbers and. file pichnamH:, lg help the F75[c;m Loader And the 
load, scsf^C"^' '■^*'' ""i^' t'^ l&Jd£d dymmiaOy. The Palhnamc 
Tabic is a linked list of iiuUviduaJ pa;hnswie entfies, \i stinTi wtih in 
entry for t^ plChliamt of ihc LruLa] Imd fdr, and indudcs any 
eiYirita fmm scgrra^nis of kind $01 CPsiJiJiarne segment) ihic ihe 
lo^dsr encounE^E-j diiiij1,g ibc load.. Abo, if mn-limc IJbnuv files lie 
icfcccntcd dytinjii piiggrsm e^ecuDon, iheif own piihnamE 
aeffncna axe iLnkcd m ihc DrigLns] one. 
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PatiifwrT^e Tobis enirv 



A Icrttd filr's hiJtniiimc SEfimenl Cst:nc - S0« i* constniCTed by the 
lEnkcc ifld cprtaicu cinf emry for each run-djm: lihiiiv tilc 
rcfciepced tiy tJic file. fjiJi cxitry conswts of 3. loa-ttTdc number, 
n]e dale aiwl (iiive, and a piitinifPC- Ttac e^a format for 
Pithciame-'ae^EJii cmriei \s gLvim In ^l^ipfc nci" PrtJgtwmsfler'i 

The Piithnunc Table Is confitnined tn rm-inDty by tJie loader-. 
its c-iujies ire S(tensial 10 Psihnatiw ^c^gmem enUics. «<£(>( 
ihai ■esrJ] aLvD contains iwn Lrvk handles, I User ID field, and 
dJrcci-pagCf'slscJi inftHmation. Figur 15-6 shows tJic focmsi of 
H PMJmiiiic Table erviry 

The fLcldfi hivc ihe following meariUi^- 

ikaAd* to nasi ■nliy; die cnemurv' handle of ihe ne<( cniry if^ •**= 
PaVhjl^rTie- Tabic. Foi the IJSI entry, the val« of the hajidle Ls 0. 

Handt* lO p«ft(lou« mntry: the mcniory handle uf the previous 
Enlir in. dm? Pathname Table. For the Rrat em^, the value afLhc 
Jiandlc is 0. 

Uwf IQi the !D (LSSOciaiiCd wilh ihis eniry. Generally, each load file 
lia.s a unique Ustt IU, and a single cnliy Ift ihe Paihnaftie TaMe. 
Each new run-iLmc library encountered diuLng eKeojucifi is MSljpwd 
the ippllcatJon"s Ustr ID. 

m* nunbw. the numbci asstgned to a sptdfiC IhmJ fUe t^ the 
lljiltcj. FUe numtxr 1 n re-wi^ed foi the initial load file. 

Fll* drila: itu dale nn winJch die E>lc w^ kxi modUled. 

FH nn*; lire Ihiie ill which the file w» lasi modified 

Ttic fik' date intl ^ Jlnw are PraPOS 15 diteeioiv items rcirievtd 
by the linker duiTn.S linking.. They aie jncbded in ihc ?jihnamc 
Tabic u an Icfceniity ctM^ck on j^jn-limc libraiy ^lea Clhcy aje iftioicd 
for olher file typcO. Tt> ensure that ihc mn-tlme library file uwd at 
progiam execuiiDn Is Ihe *ame one origlwUy linked by the linker, 
the Syaicm LOJder compares these values Lo the direciQry cntrie! of 
[Jie Oin-time libraiy file Hi be loaded, iT ihev dq nut oaich, Che 
System brtdef wiJ] not load ihe J13a. 

MrKt-pcfl^/Wock addnw ihe stafxtng address of ihc buETei 
alltHaieri Cas initial load) for the Rlc's dirert page C^e/o pagel and 
.itidr. 

iMi»tt-pog«/ilnek iIm: die size (in byicsJ □( the- twlfer jHocaied 
ftir [Iw nirt .rlircct page and Siaek, 
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Pfift III: The System Loodm 



The dlrefi-page/s-iaek iddic5s btkL sjtc fidd-s sre ir the Piihnimc 
Tabic to aJIcw ihp Rcaan fyj-LOJem to more quidiJv rcsurj-ea 4 
doiriticit appllcaU-Dji Csce "nestan" and 'Uier Shuidown" jn 
Ctt»ptcf 175 ITieue two fields arc ijjnfwed (ot njfi-timf Jibrary fUes. 

Jump'TDbila-Sacid*d flqij; a flag that IndJcaJcs wheiJi^r the bid Tilt's 
Jump Tabic sagment has been loaded iL'i value a. itwnj^s TRUP [)} 
Tor iniTlal bad TlIps; its inlHal value i:j h'ALSE (0) for rujilimc 
lltifUc'iei. 

FUb pcthncan*: ilic FuL or panial paih-ointe of rh^ entfy. Partial 
palhnasncs with the Mlnwirv^ iwU pttiix nunnbrr; are jtorwl In the 
Clbte urchanji^d {u QCKpa.nd«^- 
]./ - [he oiiicnt sppiicatJori's stibdireclory 

2/ "- ayitcm Ifbrary subdincatny Cin(ti»ll)' I'V/StaTEMjhlBS. 
whece /V/ ifi ihe Ikkx vnLunie nBjnel 

Itie Bi^tem lewder CKpandl ill other pwaid paLtnaimu before 
SEOrIng Ihtm in tht PsLhnamt TjbJc 

The piihfiime i»a Paschal UfiTig, mcaalu^ iltai k conaisia uT a lensih 
hyiic (of value n) Tolkiwed by an ASCEl suina fn bvKs longj Ifui Is 
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Mark UsI 

Ttip MarlE IJsi ii a tabic caiatwuarrd Ijy the Systeffi loader [o keep 
LracJc nf where, ikiihin a load fife, cadi segnwijl's lelocation 
tlkikmaiy ii locaftd. The Msrlt l.ia ifjccdls ic-localion because, 
ona^ a f r>de SCgmcnc la laadcii, the k^idcj n^ednt icarcli ihrmJEti it 
sgaii) lo Eind ihc ici^cationi diciiurury — the Mark lisi allnws it to go 
iDreaJy bj Lhc locaUon nf ihc segmeni's feloeaiiM) dictianaiy. 

Ffgure ] 5-7 shows Lhc fnrm ji of Uie Maik lisL 
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FIgur* 1S-7 

Mark Llal Totmat 

Th* Italdt hava IK* tallqvrln^ rnw]ninB>: 

MbW avfllloon apaca: The reUtiVE; ofTae-t (Ln bytes fiom the 
bcBinnixuf. Of ihu iviafk LbiJ to the next ivcmpiy Space In ihc Ma/k 

end ot \aUm: TTic rditivc urfset 10 the wid tjf th£ Mifk liM— In 
Dihcr wDids, \ls JJW In bjrtcs 

load-WQmBnl rumbw: The nurflt)*' f^ the load .stf^icru wh<yx 
jelixaiior dlaJanaiy is speclTicd in the folltjwLr^g fcld. 

fta Morii: Tftc letailvc nffsct (in byres frnm the bc^nnimg nf the 

load file) to the rrlDcaUcn diajonary a( tht segment spccLDed in 
[he pi^ccdina ftclJ. Mfe Mart in thi-i ulile his Lhe samu [ncmingB 
Miink or tMiTETirJHspiMUWtt, in ProDOS 16 Caec Chapter 2). 




Programming With 
the System Loader 
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Tlus- duplet iliKusKS trow v"" '^^^ ^^^ ^^ iTapatiiMticFi of [he 
SyEiem l-oadcf il scvcja] diJTeiem Jev^l*, depending On ihc 
CfimplEJdTy uE ihe pP.ig'ajiiSi yaa wish La wriie- It ibo gives 
lequifcments for designing conwoHitiR piuBrima (stidSsJ — 
proftrams ihil control Uie loading and execuiiiH^ of oihcr 
pTugnirm. 

PfogratiHulr^a sugecsfiona for ProDOS Iti arc in Chapter 6 af 
this jnanuaJ. Mora genenl infermaliorli t>rl how in prograiti for 
The Apple 1IG5 la aviiliblt in l^njgrammer'i Mlraductian 10 the 
Appiv ilCS. E-'flF HanBuaftc-spodrit programmins Ln-ilnidiufU, 
cnnsiilt the appropriatt lanipisjje maciLJil jr ihc Apple LICK 
Praatarnmef'a WrtrtcsJiop Csee 'Apple UGS PfPHrammci'i 
Workshop" in Chapter €). 



StoHc programi 

The run CI toning of iIk Sysicm Loaiter is rHjiriplcrely iranspirotii ro 
stmple a.ppliL:atiQn.'i. Any pniBram [tiai iS loa-derf mla rncm<MV m iO 
cnlircly il ihc bcujiwiing of eieaiLlocL, and whirh dues ncit ■caU anv 
t»lJ>er proscams qj routines ihai null bs loaded dunng nir tlrtie, 
need n« know »il>thin8 abtn« ihc System Loader. If SUCJi i -''talic 
program is in proper ohfcct module foemat, li will \x suioinaiJciliK 
loiiieid, relocated, and cK^cutKi wlicncv*fr II is callnBd. 



Progmmmtng with dynamic sogments 

Vou iTfjy wfite Apple JIG5 pragnins LhJi uit itienioj>' more 
C^lLtcntly (hin ihc simple a|>i.ilicallon desdhd abnvc. iF yciuf 
program ii d-lvlded imi? staU-c and dynajnic scgmeflB, ori'y 13^^ 
s\i.ii£ seffncfiVr arc iojded wi^n ihe pru^ram i? sdiitcd up. 
DyiuniBr: segmcnls arc luaded onlj' i3 needed durine MeculiOfi, 
aitd the rrwfriofy ihi^ ofcupy is siraiJablc again wtien Uiey me no 
IfWlir^ needed. 
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[>ynajiiic IrHdin^ also \S [raiupai^nt Co the TV'pical Ipplicatian; na 

Syafcm Loader r-nmniiincl* lie ncteisary to Lnwnkig ll, If yxju HegmaH 
ynuT proftfam i£ you wiiic ihe fia\}.rts cwte, and if you. define the 
prtjpct sramcni^ as 4ynxmi<: uid sutif: when the H*je« ^^CJ<le is 
Irnked, (he biniijia and erecuEiopk of dynimjic sepncnta will be 

Compldcti' auiomaiic. 

Because EcsmenB are spsdtictl la static w (tytttmlc U. link limc, 
Tou may expermtnl 'ailh sevgrjl oooriguratians of a (Ungfe prognm 
4fl£T If hai bcf^n if.wmblcd For csampdc, yow mJgtl[ firel nm the 
prngrani i& a auisLt static segmeiiL itien run wvcral didfifent sutic- 
dj-nimti: ctflnbinaLicina [0 sec wtlidl giv-es Ihe beat performance tbr 
tie amoimi of iJisnofy ret[iiln?d. In ihis way Lhc iamc pro^m 
Djuld be lailored VJ tlilfcienl machines with drfeiwil memory 
ctmTigu rations. 

In genera], (he leail-uscd parls n-f 3 pro^^fu ire lhc best cmdidales 
Tnr dynamic 5CBmenl5, sinos leading aad executing j dynamic 
segmcnl Sakes lonjfer ihin csccutinH a staiic iitgnieni. Punhcimam, 
nuking a lirgc. scldnm.ijised tegraenl dynamic rrdjhr miikc lhc 
lntUtH[o3.d or 3 prugnrn ^ter. smoe itie sratic part nEihr Joad ftle 
wHl be imillEr. 

D>'narnic segmenls can be UMd .is ati^tiayS (scgrai^nri^ a;i[h Oie aimer 
fixed staning address ihat siiccc^sivp]y occcupV lit same memory 
»Ka\ bui This siructuTC Is not recununcnrtctl for ihe Appte HCS, If 
all SCjtmenu arc Lnatcad relixaiable, [he Memory Manager has. 
fficjre flcijbility in rmding [he best plact for eadi aliocalrd 
jicsment, whetbei Or niH ti happens to be a spai:e farmeriy D«:up(ed 
by inoiiier scflmeni of ihe iliQC pragcam. 



Programming wflh mn-tlme libraries 

* Nate. AlrhotjjjJi the System Loiifcr auppojts njurtime libraries. 

ini[iil rctrases of cnhei Apple IlGS system sufiwarc Etuy nm. 
Tlia seettrjfi dJM^iscs haw la progjara Tar nin-Lime llbriri« 
■when Full suppcwt fo> ihem becomes avalljbki. 

A rjrr.tlnje iitHajy is a load Tile, like other libfa.rtej nr submuUnc 
IBcs, it «?nuirs Bereral fnuliDes thai may be referenced by a 
pfugram. As wiih other libraries, reTerenoa id It are iKioVed by ihe 
linker. 
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UnLLkc athci liijrarici, howevcc, lL! icjinientS are not phy.si-eiUT 
jfppetidedia ihe pn^rajti iia\ Tererences ii; iniii^ad. the linkcj- 
cfea<&9 a. r^erence to It in the pra^ram's load Fde. The ruri-time 
Ijbrjry lemiijns cm disk for in raemnry) SA an irtdEpendeni load, file; 
when tmc of ils scgmenU ii Etfej^jljCed during program enccutlDO, 
die seament is theri [nactd lad cicnitcd rlynainiclilly- 

Ag wllh dynsmJc £ie#nienl&, laading of run-time Libiary iegfflCflLS 'a 
transparent in [he typical appHcatioa So Sviiem Ufi4st 
fOfnniiand.9 are necessary to inivoke Li; as far as the bader is 
cn-nccmcd, the nin-limC library- IS |usl anothef load Tile WfeJl 
dynamic Kgmectts. 

The moH LtseJul dlEferenee between mn-tlme trbrajy scgmrxiti aflll 
nllici dynamic segments Is thai they ma.y be Sh£lfS-(i istiOft^ 
pro^ranis. ECc^uLtrtea for dnwing or calculaUng. tJi^lQ^ tuKes or 
graphic images, at any aihcr segmenis [hu might be of use [D Ei^on; 
ittan one program can be put Intn nin-timc libraries. And, beln^ 
dynamif, they help lrE«ep the initial lOdd Tild StalX. 

Imparlanl In i«ir>a bofh ru-vllme llb^cdlBt and Olhot dyiiaiTJc wgrrAnK. 
malw jure (bot tba vfjWnw con.tairHriQ an ne^dad BBgrnar^rs 
ana miat^t ara an itm at pj^ wne. A iaia\ ^rrer occun ir the 
Systom Leader cannot find a dyr>amic aoflrrwnt ►t needs to 



User conitrol of segment loading 

Tu make the greatest use ul [lie ^ysEcm UjaiJei, pcugrantS may JIHke 
laidci calk dJn^ctly For mmt application.'^ ihU u not ncccssajy, 
but Tor programs wjih specialized needs itiE Syfiem Lciader uiTei? 
[his capability. 

Yout application can nianuatly load oiher s^grnenu u&ing. the 1-ccid 
ScBmcnl Sy Mumbei and LoaiJ Segment By Name lalls. Load 
Segmeni By Mumtwr requires the applicaiion to know [be load IBe 
number axid se^^mcnl number at line segment lo loarl;. Load ScBHieiLl. 
By Mamc uses the load file pathname and segment name uTihe 
desfcted w^Yemi. Botli rfetum? User ID as an Input, the User TD for 
each segmcnL anrj caeh pilhnamf lec available tii^m ibe Memnq^ 
Segment Table and Pa[linamc Table, respectively. Othei sei^nem 
InfomutLoEl available Ihrciugb the Cet lo^tl Segment Info call. 
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Part 111: The Syifem Loadsr 



One a.dv!LEUa^ cif mAaijalEy Imding a d^mjinlc KgjnKAE is thai il cSiH 

be rercfeoecd in ■ more direa minin*i. Aijioinaiitilly-lws.ded 
diniamjc KgnxriD can be refcj-enccd tjnJy ijinaugh i. JSL m ihe 
Jump TibLc; tiDwever, if the segnxnL Is ck^ sutJi a.s a labte of 
uilges, you niaK "(ish ld simply access ihose valjc» raiJTcr than pass 
extcuiitm La the js^iiKfii, By nunualty bidinji^ the segmenE, 
locking JL, and deicrerenciiig its rnemoff hirdk (abuminn a 
poirier in Uie iian or the scgmcnO, ynu may then dir«L]y nefctcncc 
any Innlion In the tat)[e, Ot C0UES4, Sintc [he toadcr dncs noi 
irwlve iny SfinboELc icrcicnccs in th? mjnualli' ImiIciJ scBn^^ni, 
[he ippUcatkwi mus l<now Eis esaa suucnirc 

A prcsgran is jcipntigible fof marU.pi1js ihc scfimEnts II lo»ds, TTiii 
Uh Ji muai unload ibem (using Unload Segj-neru iJy Numbcf) ai ntikn 
[hem pufgcable and u(ilock>ed Clhrmigh Mcmofy Mini^f dlls) 

■when ^'t^ art na IfHigcr ntcdad. 



Designing a controlllnGr program 

A pmgram may cutis [be Ica-dJjlg of ina[her projyatm in OTIC of IWO 
ways: 

c Tl3r prrj^in an nulK a i-noDCe l6 gyiT call PtoDOS 16 in,d 
ihc Sy![cm Lijadef remove ihe quitLing program from meinon'. 
Thea load uid cipcuic the spedfietl new proKram. 

Q The pfogi'am can rail ihc Syslem Unde' directly. The laadeir 
loads [>ic spcdl^d ncn' prcfifSm withaul untciading [h« original 
projifatn, llien hirafc i::nntrnl hack (o [he OrigiAiL pct^ncn. 

A efiniralUnj! p(ciE*am Is an applicitian thii Iwids- and e!icaj[eK 
other pfoftrims uiLna ihc wconj jjiedioi It uECi powctful System 
Loader calls iJiai are n[jrma]!y reserved tot use by PiuOos 16. 
Ceruin tiTSCS □( findeii, s*itchtrs and shdk iniy be «>niICO]ilirvg 
prtigrams; if ytsu are wfiiing sudl a program yciu ihotJd fallow rht 
>C9nv«nidDns given berc. 



I 



An appllonJon needs 10 be » cantmlilfla pi?Ogram dcily if R niusi 
rematn in meriKiry after Ji liUs mother pragram. If II is tKctssarv 
only [h»l control refutv to [he orLssnal program aficr (he cJlled 
prinKiam quite, ihe PralKK I'fi ijyiT call is su.[l3c«nt for tha,[. FW 

eiamplc, a findsr, i^HJch atways rwums aftci an appliatlofi that ■[ 
calls quits, does ral have [l> be a compiling pfoflram-, il iS CVOl b 
fiiemory white [he applicalJon is runntnu. On the ether hand, The 
Apple liG5 PTQfirammer'y Wndishop Shell, which bis fanClions 
needed by the stibfuoanms thai IT calls. Is a cantrslUn,^ proaiam, fl 
remains ^tUvc in raemorv ■a'hilc ils subpMJgfliiiiS Meo3tc. 

* Noie: Subprogram^ are Tile type SB'S, called shell 

Bpplkarlnnfi. They loo mvst Fallow cerum convcmtinin Sec 

-Ub!ef.t Mndule rormur Ln AppU !!i^ Frogrflrttfflef'J 

■ WqtHsHop Hfl/cwiice, and Prvgrantmer's rnfroduclton lo the 

Apple na-i. 

IE yoii write a cQitfruLIng pr(3(;nm. pkaae- follow llicse su Ideltnea: 

1 The awiLroliLiiji program should request 3 User ID [or [be 
sLjbptdgram, cilher dircftSy TrOffl Ihc User ID Manig&r or 
Indirectly, tjy calling ihe System l-aadcr's Initial Load funalon 
withaninpul User ID (MaintOJ oF JSro Ttae ccntrolljng proBiMl 
shwid then pass [he reiume<t Umi- ID [a ihe subprosram in [he 
icomiulaLur. 

2, Use [he Syi[eni Lojdcf'* i niiial Load Fitnaion id first load any 
suhpragnm, Tbo riLndium reiurru [he suhproEram's atafUiia 
address and User ICJ to Vflur cDnlralling pTijgram; Lhc 
coniroUioU peoBia™ 'Can itwi decide when and lilhere to paA? 
conL-nl Id lhc Subpfi^fpani. 

?. WTiEo yoLir ctJdtrolHfig prciflrani jMASfS exeOJlion to iie 
EuhpTOgram. n niay atsQ pass paramebfra and an idunlincr 
aldtvg TJie fKiLtitcj- [t! [he bulTer craiUining thai InformaUon 
should l?c plased m ibe X Cbi^^Jrdfir word) aod Y Clow-order 
wordj rcgisiers. The huHcr should, rtwiuin an S-diaraaer sheEl 
idenllfler Mrlns, fnlbwcd by a null-tcrmiratcd Mring consiiting 
of [be ■compleie irpiil line or torrunand line ihrough which the 
subprogram was caUcA 

* Sole. ProDOS 1& doea not pass an identifier string IM 
jTonTrnand line wlliftfl it lajnches 1 shell applitallDn. Et plicM 
zero« in ihc X and Y [egistera. 
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4- Vo«r COciLmlJing prciRtam Ls responsible far Mtabltahirg the 
appiafMJite inpt|[ anj (JULpj[ vcaora for lu Eubpicgsms Fnr 
SKample, when ProDOS li ]aunr:he3 ^ JB5 Tik. ii scis ihc global 
I/O ^Qcha to podnc to chc firmware Pascal dfiven fn* SO-iC&lumn 
so^n 3n<J ke^'btiard. The jdcntificr sirtng youf 'tonCmHing 
pEDgcam paASca in the Subprcpani allonn jt to ch^dr (o nute sure 
It is running in (he proper WO ^fivj rCifiiKtHI Cchal is, under youi 
fonlroJIirtg pnjgram a/ld uiM inarhcr). 

5. The cuntroiling program should olKtrw Uic PraD05 IS 
KKivcnllons for regiilcr initiilliatjon ind dJfMl-pagc/sia-ck 
■JlucaUon. See Ch*p[*f (i. 

5. If you wani ycMt cnnrrolELng, progara iCi Support ihcLl 

appLicailnns ilai lemiinaJc with a PfoDOS 16 Q'JTI all, the 
tortniLUnjt pingrsm fflDSt iniciccpi all PnjTXJS t^ calli. Thit 
way *i-hen a aibpiourain quirs, iJ^ laintioHinB ptogiaimi rather 
Lhan PrnDOS ]6, rcgaim tijnlmJ. 

7, When ihe sJictl apu^Jt^Einn cilis hack to the copvtrmlling 

progMffi, ii \caves sn errw code in ihc .accumuUtoe. Twu vitucs- 
ai^ reserved SCOOO means ng errtB'^ ind SFFFF means a non- 
specifif ahcfl-applicirJo'l -CJior. Your cojuroUlng program ind 
HibproBcami fiiay Jdine any oiher ■grrorB as needed. 

B Your ctantcolling pCOjnm ii tatilly if^jpofisi'bk for the 
iubprogram, s. riffiposlUon. 'When [Ik subpnjgrani Ls flitlshed, the 
eontrolJirtg pra^ram must remove LI from tiKinory and release 
aU icsourc^ Bssuoaied will: iu Use; tD. Ttie best way lo ijo tJlJs Ji 
U> call Lhe Sy.stcm Loadfif'a User StniLdnwn funrtLort. 

9. Jf [he subpragfiJii l«ft(/majiuaUy loaiis nlhci programs, then It is 
alMi a COitmiuUing progf^nt srtd must ohscive alL (hfl conventJuiB 
lifitcd bcje. in pafipcu Lir, it must tie csrmin [0 dispasc of eiU 
memory icsuurocs a.'(!«da!e<J wiih the subprc^ram iliai U 
loaded, befoie iuetf quilting and pacing CTmiral t»ck to the 
OEJgLoa.1 crinLrolling pi Ci gram. 

The pnctio; a( using sheU applitatioiH is. ramra'lling prcgrama 

Is discuura^id 



Shiitlliig ctown and resfcutlng appllcotions 

Thfoush ahemaic use of ihe User Sliutdowii snd Kcsiafi fuixilwii. 4 
KmtiDttinjs program can tapLdLy switdl eiccutinn among MVesil 

applicaiions. If none oF an appLiralion'j static segfncnls tiavc bctai 
remcved /rom memury since sh^jidown, Restart brings the 
iRplJeautm bach rapidly litutause idiik icc«3i ii nai. icijuiucd. 



Huwever, only s^rLwaic that is rcstarlable can be restarted Ifl this 
way. Restanible software reliitislizcs its variables ■every time it gaifli 
CTHiirtil, ii makes nn aruumpdans iboiit ibe state of the machine 
w1^n it starts up. lEa aub|Mn^m CK^ with 1 C^t'? i^alL, Ll apcdCci 
whether it l5 rcstaitabic m i»0[; oiheraiw, ihc cariralllnji proamn 
l3 lespnrkiible tot dcddirvg whether a prt^Bram qualifier n 



Summary: loadei ccilEs categorized 

11m foDowlng taWe caicRoiiics System Loader alls by the types of 
ptograms Ihal maltc ihon. Moat application!-, whether llicir 
Bi^jiDenls are static ui JynamJ';, and whctlici or not they ijse ruJi- 
time hbrarles, need make none of these calls. Appli<;atlDna tfni 
load dynamic sc-gnM^nw ma-nually may caLL any of the umr-c-oildble 
futtCliOfU Contfolting prcgraras and FrsjDOS iS call tJie sy^usm- 
ivtde Eunctians, Only ihc SySIcnl l^ilder itw^lf may call llie ItUemai 
ftincttutu. Functions noi HsU^^i in Table 16-1 eilher do ino(>iing or 
an; ^icecutEd only at system siaioip,. 



Jvibif 14-1 

Syttom l.oad»[ ftincllffn* categaitied by collar 



Ulwr-CaBafcta 



Sri>*m'WI(J» 



Inrtoma! 



Loflder Version 

L0a(3cr Stilus 

Load Segcncm B.y Number 

Unload Scgmcnl liy Snnlbef 

Load Segoieni &y Name 

Unload Segment 

Get Load Scgmeni Infa 



Iniilal 1,md 
RcMan 
CEiUscrlD 
Ge.t Pathjiamc 
User Siuitdcram 



Jun^ Talilc Lotd 
Cleanup 
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Chaptef 17 



System Loader Calls 



Introduction 




descSbai the rdbwing calls: 


NunUHr 


function 


PlUpOH 


101 


Laadtr InltiiUzaUDn 


ie;iecawd at syslcm 
sUrtup!) 


iaz 


Laader Siamip 


Cno funCli'Oll) 


£03. 


Loader ShuEdown 


tno function) 


J04 


LoidK Veesion 


reiuffls SysJcm Lofidei 


W5 


Laidei Reiet 


(no EuneclonJ 


$d6 


lotudn Suu> 


■ciHTTUi iiiiiialLzaciork 
status 


SO? 


Initix! LDi.J 


Ifuds in Appdlcdlicm 


SOA 


Re::;iirt 


rciuru a dormani 
-BpplLraLion 


SOB 


Losd Scfincni By Numbec 


loads * single segmemt 


soc 


Untwid Scgcticni By Numbci 


unlofl'tfe a single Mgmettf 


iOD 


Loacj Scgmeni Dy Nanui 


I'Cails a single sc^jYiCnl: 


iOE 


Linltfad Segmeimt 


unkiadi i ilnigle scgmmi 


lOP 


Gei LMd Seamenl Infc 


iciunu a wgmcnL'i 
handtr 


J ID 


GdUser [D 


retufTU L*ef ID Tw a 
pattinaine 


Sn 


Get PjiJmamc 


prCiJcns pattinaanc for a 
User ID 


Siz 


User ShuidowTi 


DU.k:csi in appliti^IlOA 
SosnlifiX 


" 


Jump Tabic i.a3.d 


loads a dynamic ^atlKflt 


- 


Cte^ntip 


trees mcmciry spajrc 



I 



an 




How calls aro mad* 

Hie SysHem Loidcf is an AppJe I105 tool MI (COo] number 17., or 
)iexa.clednu.t Sn)' Vou call Jis fLuictions iMirg filter nacio calk 
(nnt d^crjbcJ Siere) or ihc siandaid Apple HCS Lcinl taUins 
Sct^ucncc, aj CaELow.'i: 

I , PUih artj" :rquircdl spaa^ fqr rctumwl results WHO Ihe SUdL 

3 Piish eicti inp\sL value aniD [he scadc, in the pmper oidee. 
3- Eneofte the (rtllowf^s ciill bltxi: 



J3L 

where 



t$]ltFll.|l«NUllll 



tS3-l d Jie Syi^tem Leader mcl sn number 
rmkcHUB, is xfK mimber of it» ftinoion bf^ins called 

(IS nwani ■jihiTt left by 8 biU".) 
Dl_B.patcb*«^ a iJrK: aJdicm ot the Tool DispatchEi 
CJEl MOO), 

II Is ihc rcsponsibiliiy of Lhc aiisr fugujlly a coniTOllbnj pfagram.l 
la picpxrc ihe siKk fm eich runcHon ii calls, aiid ta jkS any resiilL; 
wJT ih* si-sck KntJi Mitiis is recufncd. Ln the acoiftiidaior CA, ifigi*[cr>i 
funhennoec, ihe ciiry bit ii sei 0) if tl'e ftiH i* unsuorrasfiil, and 
>dC!arcil(Ci}if [he call la such^hFuI 

The Jump Tabic Loid funciion dcief^ |5Gi[ UM ihc above callLng 
Mqucntc, and caiunx be called dit«c[lv by an appSIcatinn. I[ Ls 
tailed indttectly, dJTOUBJl a call lu a jLimp Tabk entry, "m* atMOtLi[e 
aihirsa Of ihe funalan Is patched into Eh? Jump Table b/ ihe System 
Lcodcf Blh^ dcn«, 



Parameter tvpes 

There ire fu jt types of panmcEera pa&&td M [he s[ack; values, 
resLilts. poifilers. and handJes. Each Is pittier lEl (flpHi (O or an 

OHJjUHj/^ra iJie Ifiitler funnion bei^g railed. 

□ A vakx '\s a. nLuncnml quajiEJEy. elihei 2 byies (wcrd:; sec Tihle 3- 
13 tsr 1 lyyicii OonE wotdi In Icngih, ihai the aJIcr paases tn the 
Sysiem loadei' li i3 in inpui paramclcr. 

D A KSuli u 1 numerical quantity, eiihcr 2 bytes (wtird] of ■( bytes 
(bi^ wnpd) in lengih. that ihe System UuKter passes back eo the 
caller. U is an nuiput Fanmeief. 



A potnUr is [St addKiK of a locatiOTT ctmlalxEliig dab), code, or 
buffer ipice In whinch [he Sysiem Ixiader can receive <m place 
data, A pointer may lie 2 b^'teS Cwnrd> OC 4 bytes Ooi^ wOftO in 
lena*. TlTie polnwr liself, and [he data It points le, may tie eiihn 
« put Of htwkjjul 

A handk Is a, SpedjI type of pouHSfi It Es 8 poimer [0 1 pointer. 
[[ is the 'I'byte address of a locaclon that Bsel/cotyvfi-ns Uu: 
address or a iDcaUon couuifllfig ciata, code, « buffer apace. Jn 
Sys-lcm Loadei calls, i handle is always an oulput. 



Forma* for System loader call ttescriplkirts 

TtK fQllnwine KOiurH iie&Cti"be [he System lyacte' nilLs m tfetail 
Each dcsrriplioil contaifis these elements; 

D [he fuU naiTffi (tf (he call 

a a brier description of wha[ fLifkciion lE performs 

n [be aHi's ninalon mimber 

D (he eatl's aascrably- language maoo namn (iiM Jl If >NW make 

ixiaou trills) 
□ the call's paxameEer lis ClnptH »nd ouiputj 
D flw stack cimfigunEion botti berore and after rflakLi>g the call 
a » ]isl nf possible errar Dfides 
[I [he sequeiu^ of events die ca!l3 IflvoJies tif the brief tIeseftptJon Is 

nni ctsmpleic eruuijh') 

?aramalw Dst mb: In lhc paiametei JLs^, iriput parameier! at% 

listed in [he order in winch d«ey arc pushed oislo the sti"^, oii^faii 
paiametett ifc listed in the circter dcii -which ihcy arc puilt4/n?m the 
Stjdr, Check the Btadt diagrams ifyotl arc tinccnain of [he pmpcr 

□f-dcr in "s^hich [0 push anji oT the paramciert. 

Stack dloflram nota: llnliltc ether mcmOiy ta.Mcs in ihis mlMJil, 
ttK stacit diagrams ate uFuanizeti In units tif iii^mii — ihai li, each lick 
marii itpcesem* Jwo ^twr af s[ack spatre 
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LoacMr Ihitlaltzotlon ($01) 

This JOulLne JnitiiiLics Htc Syslcm Lcaitcr; tC J* caEled by !hc systtm 
SOFcwaic II tioc! [Lrcw. Lcadci- Initiniii^UUn dean all Iw^Jcf Qblfii 
ajid sew Lfkc iaiitiiL ^uie nf ihe syatEUi, miliJrg *10 a^aumpCicins. aboijt 
[he currcnl w prev joiis stale nf din; niachirr. The System Lodd±r'i 
l}lH*al variables <see Appendbi O] arc <tenned m [hia liimx 

The IfiiLialioiipn rouune i» Ecquixcd ftjr aU Apple UCa lool see, 
Macnf h4gmK L^adecinit 



Loadef Startup <$02) 



TTie Starnip rrnjtinc l5 rc<piJj>Eil for alt Apple IIGS (tjol 5cl<- Far the 
System LLtadci, this liuicllail lIo^ noLhiiiK and irccd glcvtr bi 

FuntHfTi NLHnb«r:302 



I 



Paromaters 



Parametftn 



PDsslWe errort 

(none!) 



Possible error* 

tn,on«J' 



C^l^lei 17;Sv9t»m Laader Calb 
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21h5 



P£id llllTha Sya^am [.chjil;!^ 



LoQd«r Shutdown ($C]3> 

The Shucdown imjUnc if r^ujred (ot all Appte UGS lod seis. Pdr ibe 
SysiQoi Under. ihJs lunaJDii does nodilng and nsed never be 
calted 

FuncHon HuinbM: $03 

Mocro Nam*: LdadecShLit down 



PorametofB 

Crane) 



Possible eiTon 



Loader Vwslon eS04) 



The LoaiJcr Vcraion furctiun rtUirrtS iJie veJSion numbcf of the 
System L^IC^ irurii^nUy trt use. Thr vrir^ion nLirobcr hu ihJt 



Volua- 





Bile 1 


Ev+ffO 


1 


15 14|l3|l2|n|lO|9|B 


7 d 5 J 3 2 1 |0 


1 


B 


Malar Rel-ea*e Hq 


Mine* Release Ne. 








1 



D Byte u Lhc mincT irJeasc number < - Q fa> SysCfni LcxultT 

D Byu- ] i& the miliar xclcflsc number ( ■ I for System Lonilei 
vefsLen ] i» 

O B fflie most ftlgnincirU bit of b>ie 1) - for Einni defeawis 

' 1 Tgr all piot^HypC ic[£ll±I 

Thr VcisLQiL roulinc is icquucd In aJ A.ppEc DCS IodI sdS. 

Funeltan Muinb*i: Sn4 

Moere Nan*: LitiaderVeraian 
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S'tatk Before CaHi 



iiesun ipac^i 



«tIKb AAer CplL 



-Sf 



-!? 



PcssiblQ errors 



Loader Reset <$0S> 



The Heset njtitira! i* rpquiird for all Apple I1G5 QMl sers. foe The 
Syslcm Loader, liiis furiE^Du due* IWlhilJlg and need nevtr be 



Pammeleis 

(none} 

Po&&lbla airor» 



Cruptef 17: SyBtwn Looder Cain. 
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Loader Stofus <$D6) 



This imitinc returns ihc ruircnl saiui Oflililllzed OT untalUaJiiffirf]' at 
ihe SyiMitl Loidef A nooiero sesull mans TRUE ittniliaJilfid); a 
icto rcsLitt Ewaiu FAISE CumiutLalLtfrf). A «sull aTTHUE is ibrays 
iMiiined liy [hfl caL becaiue the System Loid« is iilwiyj^ Ifl ihf 

ITic Siiais rciuijnt Ls rcquiieti For lU Appte UCS vod itii. 
FurKiiQii Number: JcS 



Paramelais 



Ronu 



Slit end Trpa 



Input (none) 
Dcitjiut lAasus 

Stock BcfQR ColL 

I pray Qui, conlerli. 

Stack AAcf CaOt 



wani ceuh C2 brms) 



Errtii? 



SP 



Possible errors 

■(none) 



Inmal Load <$09) 



This lunctlon Is- called by i rcntmljinii pmgrarn Csjch ^ a jTif ]] Ot 1 
&wi[Chei> Id ash. ihc SySICm Lcddef \0 pedofln lA initial load a( a 
pm^am 

Fon(ll«n Numb«r; S09 

MocrffNaTWilnicialLaBd 



Parameters 



Honw 



StiafXidlyiM 



lopui 



Oiiiput 



Vkv id 

sddress ofloai-nie 
pa.[fanAine 

special -memory flag 

UsrriD 

tuning addrcu 

addresA uf dlrefi-jrage/ word poinLpr C2 bvte&> 

Slack t^cr 



word tilue (2 bywsj 

word value (.2 byiesj 
word rrsull C2 byte*> 
lung woind pointer U byliRj 



sizr of diirrt-pagc/ 

wack buffer 



word, rcsull G hytCs) 



Stack Before CUL 



prflvioua CDPierrls 



ffSjLtf MKcel- 






;>P)ii't jpctM?! 



l*srt-n 



taorfWB noma 



ipgcva -fngmDiy fujg 
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Part lll:Th« Systsrn loadw 



^ 


' 








Stack Aftn- Call: 






&inji(jjipun'un"E 




dT- ,n.i :?=/:■ 'dTf lira 




dLi. pme.''ii'ai:'.k qij:^. 




. ir^nu JKW-eir - 




iStiCi 






■•"SI" 




PcKndlsttt enars 


, 


$1104 FLIe Is not J load FJe 




S1105 Sy^^eehi Lci.dcj' is 'busy 




nils Se^'um oui tjf seijutncc 


^ 


$1 10A Illegal Inid rFcord fi^urcl 


■ 


H SlIOB Load lament 1* ftKeigd 


■ 


■ iOQxx PioDOS 16 cnot 




9CZue Memory MiRDgei enor 




Sequence ol events 




■^'hci lite lAiiJiJ Lud.J fuiiciian a LaSEcd. (lie following Eequecws of 




events Pteurs. 




1. The function checlu Ihe TypalE uid MaLnID rieldsofthe 




spetinEd UscB [D. 




a. If Ix*!^ Mds ire ranzcin, [he System Louder uses k us allocate 




apace ftsr ihe KgOKnu lu be imdci 




b. It ihe typeiD fidd is WO, [he Sysiem Loader obifllns a new 




l.'ser ID Frcim the User ID MiniBcr, io assign [o all segmcnia rf 




thai file. The new TypoID il given ihc value I, meaning ihsi 




[he tUW :n]e Ls rhwifii-H as pin PpplkjUOil 




t- If only The MalniD field is zero, Ihe System Laatlci ctnains a 




new User [D ftom The User ID Majiasa, tujng the supplied 




TypeJlH and auiXID. 




The User ID HanaBct (dc.'icjtbed In ,^ie UGS Toolbox 




Se/erfTiaf} guijaniees that Cscr ID'."; are uniqu-e la each 




applicatiDn, irtol, drak jccessory. and so fnrih. See Appendix 




D ■oTthia manual far a hripf iJescription'Of iht tiset ID 




rormaE and the TypnlD FicH 


■ 
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2. Thefancteon checks, ihe value nrihe spedal-Tnenwri.' Elag IT it 
Is THL-T <j>anzt:i6), llw Systr^m Lmttef will not it^id any iWrt 
segments Into 4p?da] mcmoty Cbanfe SM ant! 5*1 1 —sec 
Chapiei 3), Tbe speciil-memoiy daa d«* JI'H altcd ihe bid 
iddfcsscs af Hiyfiifflic seamcnti. 

3. TTic runctidii alts froDOS i6 !u fjpen the specified dby 
pnhn^nmli load [iLc. If any PkjDCIS i6 error OCOJIS, QC if iJlB file 
is. nnt a load, file Ctype SS3-iBE), the System Leader rerurns Mx 
ippffiptiaxs errar cdcIb. 

♦ Nate- \f the loarl Hie Is i PloDOS E system file Ctvpc Sm Of a 
PraDOS B biiUfV Hie [lype JO^X ihe lojdccwdlL noiltHd li. 

4. Oace the i™d file is opened, ihc System Luadsr acids the load- 
file infoimatit^n ttj the I'allmamc Tabic, ind. CtUs Ltie Load 
Segifleni By Numlxi funojun Eoi e»ch sLatic s=B"neni m the lead 

ftlE 

D ir any SiWC sesmcnL loaded b an IditiilLaation Segment 

teegmenl Idnd-ntB, lh« System Loader immcdiitelir lran5feJ5 
Mfltfol lo JL WtKn itie System Loider rea^i^ns LUHtaLiI, it tcwds 
ihc refit of the slatjC segtcicnts 'Wilhoul paning ionvol to thcm- 

D If i ditea-pajte/'stick segment CKlND-i m is Itiaded, die 
Sy&wm loader rtrtu rTi» [lie sefimsenfs starting a Jdn^^ and size 

+ iVMiT- 'ITie Sysiem Lnadcr ticaU a diTfiCT-fHRP-'stadr scgmtfrtt 15 l 
Indeed, ttfi]Mjrge-ablc, staJc jcgmenL The segmcjit cannof be 
moved ai purged as long is [he application is active, but it 
beCQcn^? purgcahle at sbiuldiown. 

3 If any of iIk sialic segnients cannat be loaded, [lie Sl'steir. 
LOJiJer abons tt»P load and iclunll the erroi from the LOatt 
Scpncni By Numbei furtolwi. 
5- OnLc h has laidcd dill iJie mVc 5CBraenls, ihe System Loader 
ie[ijnls the Sliinins addicss adlie fijst segflier^t Colher than arl 
initlaLliadan scgtnent') rjf luad file 1 in the contruUii^g praRram 
IJ then Iransftr^ exeonlon in Ihe cnntitnllirB pro^iam. The 
CtMUTOlling program itself is rtsptuwlhle fnr sctUriB the ia6t sua! 
diictl rcguCcTS acvd Eoc Itansfcrring control to the just-LtHded 
program. 
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Part lll;Tb0 Syslwn loader 



Restart (^QA) 

This funoJon Is caltcd by ■ concnriling ptfigrim (^uch is a gheii ur i 
5wi[chcr> to a^k Ihe SyaL^m Loaicr tn msuraci^ a doimlill 
appCl^iJijci — (Kic Liiai hii been shui down i^ ihc Usct SfiuWown 
funcUorv), but is SUll in mcmnrv. 

Only praig(TLiTt5 ifiai are icilirtiblE tan be succesd Cully tesuircocd. 
ihiuugh ilus r^U A resiaciable ptr^j^am always (eidiDilfees iia 
TOrjablM antl eiuJ^cs no usumptiQiu abcui madiitu; sute each time 

To rtiakf a icsU-rtiUle, i piragrajn miy include > Reload augment 
COnlJJnJng a]1 necessary InllillilEaEiOii Lnfrnmalifln A ReSyaii 
Scgmcnl B always lojticd Fnjra lh« IJle 31 SUnlup. even when a 
pcognm l> jTsarlcd. 

♦ Mj/e. The canunllinj) projfiirt) thai malcc^ the Hestart fall is 
nsporuihle for makiiig sure ihaj the pfogcmi Ji spctiElcs is 
iBfle&l r«[aftabLe. T?ie System Icadai mikes na SLidi checks 

Funcllon Numtnc JOA 
Macio Noma: keian 



Param«tfln 




Ham* 


.Stn end Typ* 


EnpuL 


a^r ID 


wen:E value (2 bytei} 


Oucjjvii 


User ID 


wijrd reailt CZ E>nca> 




SCailing, addfcs! 


lona ward po^nwr ft byies) 




(((JdfMi uf djicc 1-page/ 
Sack buiTer 


ward pain:er [2 by[£s) 




lizc of dirasn-pap/ 

JtlCk buffer 


wewd fcitiir (2 byia) 



StaE:& Befare Callt 



ora^gui f:On'erila 



riBJLitf jooc&j 



rraiiiffiiDacej 



fftMUTJOflce; 



i;i;;i,iV tri-ji;i;' 



-SP 



Stack AAcr CaDi 



praiMu eg me nil 



cW. noofl'/jloiHi sag' 



c^i ryrap/sijcJi odd' 



JJifiUD. 



-SP 



Possible errors 

IllOl ApplLciLtiDn 31V1 ftxiiid 

$1105 System, Under Js busy 

$liaS user rCI crrar 

9KxK ProDOS X6 ctoj 



Ssquence d event's 

Whtn Lhc Elciiait hinaii:io is called, the follnwing sequence nf 
evolls Di^Cura. 

I An CKiMinj: rwmiero User ID musi be spcdfiwl Cthe Aus ID pin 
is igraiedj. If the User ID is Tcra. errai $1108 is rrlumcd.. If [he 
User ID is unkr»*ti to ihe System iflader. sTmrSiioi is 



Cl-K^tar 17: Systam Loaaar cate 
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PcDl ID; Tns Syitflm Lcodar 



2. TheiJcsiart funfUfin can wurk ofJj' if all of die specified, 

prc^ram'i suijt segment are h1]| in memofy. WliiL [hi( means 
te thai no s^Rmenis in [he Memory Segftieni Tabic wiUi the 
spcdTiHii User ID can have b^il purged. 

3. Ttw SyMcm Loader riiccks the meniiMy handle oread) 

Me-mon' S*^smG:ru Tjbfc enLiy wiOi ih« U^r ID. rf none are m[ 

1o Nil. :he segments are a 1 1 bi memDry. 

l>. "ilifi SyKti^nk UikiJcr ihcn rtjuinecu ihc application by calling 
(lie Memcry MjJiiger [o nialfc eadj of the appiacatiQfi'a 
se^nsenu unpujBcabte arvJ tucked. 

c , Tlie loadkii relu ads any Scload segiticnL-r it finds, md eKcaiKs 

arty liuUalizitinrj seemcnts ii fLn<fs, 

d, ITi^ loidlcj- [ctuniii [lie appLicaliori's. CtHllplCte User iD. the 
fust MgitkcHt's 5iij-iinf5 addrei*. iniJ the direct page and itadf 
infurmaLLDn ffnorti tlie Pathname Tabl*J [□ tbo caWer. 

3- If anji oflhe application's SlaticKsmeius are no lim^j-ln 
memnry, |}|« Cunctian dnes thfi folJuwinE; 

a. ir caL? the CJeanup [(xjiin^ m purge all nzfercncea to thai User 
ra from the 5yjtem loidci's tables and deteie Ihe U.wr ID 
itsf^lf 

b, IL calls die Iniual Load funr^ofi to load ihe applEcatinn. TImi 
applleaiinn itq^vh a [>ew User [D, whJdi 1» relumed la (lie 
alicr 



I 



I 



I 
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Load Segment By Number <40B> 

Tk Uod ^E™"^ "y NuttUiCF HMtine is dhe worlttmisc (uncUofl of 
the SysUm Loidei' OUir^r SyaWnl LCiadftr functions tliai ]ofld 
segment rto so by nlUnJ iJlJri fLinclicin. It :ojd* a spedfi-c loid 
fic^ciH. into mtiJlorv'. Ut* scgmcnl ia. Speeiticd by lis Imil-file 
number, load' sen men t number, and User id 

♦ WOie. AppllcaCLnM use thg!» ruiKticn in manualiit load <Ji'namii: 
seflmcnia. An applitaiiLifi may also ij*c Laid S42Bmct<l By 
Number lO nianually Inad a JIflffC scflmcnL Hawever, in thai 
■case »hc System Loadef dcie:.i nm paidi ilit fwrcct adtlics^ of 
the newly laided segment onio ajiy exiting icfcrentes to i(. 
liiHefore ihi; scgmcni caji be accessed orJy ihrtiugh iis stanjrg 
address. 

Function HumbM:.SOB 

Mocro Nnn*: L(jedS«3Hum 



Porcinntttars 



NDrm 



Sba and \ipm 



Inpul User ID 

load-file rumbei 
Icad-scamtnt fiunber 

Output ^ddii±s» of Kgment 

Slack Bcftirr CalL 



word viluij O- IwigO 
word value (Z byiiu) 
ward value (2 bytes) 
Inrag wortl pointCf C< bytes-) 



— freiuif TpacBJ 



Lfiert.T 



fciQr^^flig' ruimbigf 



iWJ-tggmen^ rK? 



-SP 



12a 



■Pari Ml.Tlie Sy*'**^ Loader 



5a«k Afier Calis 



ptiavlpij!! cgn^snt 






h*-jp 



Passible 


error* 


511.01 
ill03 
S1104 


SegmenL nat round. 
1/HMmpitihte Omv yer»ion 
Pile J9 [Wl 31 Inad fjlc 


ill 07 


System lojidf f is busy 


*1109 
illOA 

SllDB 
SOOmc 


SegNym Oul tjT snpjcutE 
tlkjfiL Itwd record round 
U^ad EGgnienc Ls farcJ^n 
ProDOS 16 error 


So 2^ 


Memory Man3.ger <rf CM 



Sequence of event* 

When [he Load Sr^gm^nt By .Vumljer luimian is cdled, the 

1 . FJrs[ the loader ctacks to (idd oui if the requeWol load segmcni 
is aiceadii' tn fflemory: it scarnzJiflS. cfie Memory SrgmrnI Table 
to dEEenmnc If ihet« is an mUy ftw the segmern. If [he cntiy 
cxLys, IhK loader dicrks the vn]\je of ihc mcmoT hanif? to 
fifid tiul wlitthqf the corresponding mgmciy block is slQ] in 
memory irso. liic funciion lemlnaics wJEhom ferufnjdg an 
oToir. IE 3it «iiUT ensis bjl the memciJV bludt hai been pijrged, 
the asntiy is ddcitcd. 

2 , If Uie se^tmcnt is not nEfeady in memory, [he Si^siein Loader 
JoDJB in the Padmamc Table tq get ihe load-RIc paihnamc from 
lh« loid-ljlc njmtl^T. 

1 The Svsiefn Leader chtxki the flJe type of the referenced me, If 
■[ is noi a trad file {lypc iH3-SBE). thsn error SUM Js 

irtuin^d 



» 



4. ir [he lite Is type Sb4 Oun-iirne tbrary file), the Sy^stert Loider 
rompiics the fik:-* rtiodifiatlofi dace and time i-aluies ta the file 
dale Hid file time in the Paihnime Tib5e. ]r tliey do noi tnaKh, 
effot J]iD7i5 returned illd [he losd Is nfW perfamied. 

5 . PraDOa ] 6 ia ailed lo open the flic. If PiiiDOS 16 cjnnnt optfl 
the file, it returns an apprijprlaie erww cnde. 

6. Jiftci ProDOS 16 sucoeistuillv opens the Inid He, [he System 
[■OadCT Martlies ihe Tile lot a toid scgiiitni cofre-'vponding la 
the spedned laatl-aegirieiil n.Tjmlx:[. If none la found, crrnr 
SlJOl is renimei 

ir ihn load scgmcrt is fOjdd, it? header Is checked Csegrfient 
headers ir* describtsl under "Objcci Module h'o/nut'' in 
Afifrle lies Pi^rarKruer'S WOffcAop ffe/ervnc^ If [he 
£egnten['& OMF veraion tuimbcr L^ LntompitibLe wjIJi ttw 
curtem System Loader vcision. error JII62 is retuincd. if the 
value Ln ilie tieader'.'J SEGtniM. field does rot nuncli the 
specified Jaad-scgmcni nuttibsf, error H 109 is returned. If [he 
values in [he MUM3EX and ITOHt-EN Wds art rwa and i, 
T^peiTjveiv, sinor SllOB is returned. 

7. Ifltu! load scgmertt isftnjnd and lh« hcad^ls cari^L:!, a 
memory block o^ ttie size apedOed tn the lephSTH [IclU wf the 
jeBnu^rit header i?. requested frnm ihc McrrKiiV MjflilBsr If the 
O-RG fieki in ihe segmcnl header w not icro, tlnen a memury 
bicick .Staitinjj fX ihc address spedljcd by DRS lS reciiJesCG'd 
CobQ is normallv ?ery Tot ApfJe HfrS proBrammLria; that is, 
mast sf^ments ai'e fclocamblcX OOicr segmcni iLiribuie« trs 
set according [u vilufis [fl fHhfir" Wgmenr header ficltfc — see 
Chapter U. 

S. If a nonaeto User ID a Spciliiied, the rfienwiy block if given 
ibat Use' ID- If ihc spedJicd L'sa ID is zero, the memory bWi 
b given [he cunmi User ID Cviliie of V^SEIRIP gl^^ 
vanableX 
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Pan Ilk The Sysfam Loacter 



9. It [he itqucsicd memory' is noE Available, Lhc Mi!init>ry Manager 
■nd Systeik loader llsi; ibcsc tcthnJqii&s (o free: space: 

a. The Mcninfy Mlttagct unJoa-ds unrveetted se^mcnls hy 
purging Ihcjj- CQrw_5pwi4ifi* memoiy Wacks. Blocks are 
pvi^d iCcatOlng lo ihcCr /Jurge lef.^. ^cw Cjiiinpfc, aU 
level-3 blodcE are pureed beftm: ihc fust level-2 fcrtrjck Ls 
pLtrftSid, AfiY JifjiimiL ^£g!nen( whose memon' block's 
purse level ts MTO oimai be unlomied. 

b. [f 111 jSiigcabic segments liavc been imioaded and ihe 
Memaiy Mana^r siiU aitnat allixaie enough memary, it 
moi'ta my rtwtnable bltjclu [o enlarge ccntiBJtws mediory 
ams. 

C. ir all eligible m*mcify blocks ha\'c been purge-d or inDVBd, 
and the MfifnOiy Mmagei jiuK (innoi; aJLucicr eiuaiagh 
meiwory, liic Sc^m Loader Cleanjp j-ciuilne ii oiled la 
free mv i>nj.S«l pans of ihn S^asem La«iict"i mcmtwy. TTw 
Memury Manner then um?» a.n*!c more irj jllocite [he 
requested memory. 

d. ir tbs MemoiT Minager Is Mill unauf (tssfal. liw Sysi^m 
lisacter :c[;j[iu the lasT Memoiy MajUEcr Cfnw [hit 
ot:i:uiTcd. 

10. DltDC The Menviry Manager hu allttalcd the tcquesled 
rtiemcif^'. ihc Sysierti Ltiailcr pul* Umj lead sejjmenl insp 
memory, and prntesses [lie re-JaciliOin difll!>riar> id any). 

* Wars.- H any ceoonl* within Lhc segment arc nni cf a pr^^r t^qse 
CSE3. S£5. SFI, JF2, or SOD'), cnar SHOA Is rfiturned. Sec 
Appendix D for an tacpJinaiinn of tecord types. 

ll- Afl cnliy fo* the Mgjnent is added so ibie Memory Segjntal 

T»ble, 

12. The Svstejti Loader rcfuffis ihe suitina addicts of the segmeni 
lO lhc auitrojlif)^ pKtjftim. 
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Sequence of eventt 

Wbcr [he Unload Segmem B^ Number lliincijnn Is (aHeJ, the 
fnOfwIng sequence uf cvrnts occurs. 

I . TtK S^-Mcm Lr»def KirdKS tht Mcmoiy SBgtnefB Table for ibe 
spedlied Loid-filc jiujnljer acKE Icadsegmcni number. If ihcre is 
flo sutli entry, errar Si 101 is rciumML 

1 . [f ttie MenlOjy Scsmcnl Tiblc cntcy 1^ foUTKli [flC loader ralk [he 
Mcjnojy Manser nj nuke pwgsetblo Cpuigc level » iJ Ihe 
memory blodt in which the segmem cesidts. 

i . The loader changes all «n[iie^ in the Jump Table that J«fere<l«e 
thf urJoidcd scgincni la (heir unJoaded siites. 




load Segmant By Nam* ($0D) 



Tbi» fwrntaJon loads * namtni segfiient inlo rnemeuy. Tbc seemcnl il 
(Ijmed by il9 Imd fOc's jMUhnaciw, and lis scamem nsjnc (fiBf" «« 
SEGHAHE fictJ in ihe wamcRl header). A n(fn.l«tn Usel 1[> may be 
apeftfcd if the loatlcd Bcgmerti Is to ha-re n User ID nilJTerexii from 
tt^ ountfil User rD. 

PtaicHcn Nmnbftf: ioti 

Macro Nam*: .LoafiSegili-'^ 



ParanieteTS 



5peciol condilkjns; 

□ [f ihe spedfted User ID Js zero, ihc aiHeni Uset ID Cvilue oF 
USERID> K awumed. 

Q [( both the Luid-rilc number and iDsd'-segmeni numbei aiE 
nonzcm, the specified segmBii is unlaaded i^gaidJcss of 
wheiher ic is slalJc cr dynamLc, IfeiiJier Input is zero, aniy 
ifynamd icsMaen]^ are unlmded, i^ naEcd nan. 

n If rhc jpccLFied loiad-lite nuAiber is icm, alE dynamic segments 
for thii UscE ID 3ia unltMi'ded, 

P IT rhe apcciHicd toad-scsmcnt numtCr is icio, all dynanic 
segments for Itic spedfied lulJ Be arc unloaded- 

* ,VaW, If a slaltc KgOKm la unluadcd, ihc apfdication (hat ll fcs 
part o( antioi be jcstirted frnm n dormam suie. See "Restait" 
Aad "UsEj' Shindowji.' in ihds diaptcE. 



^{^Ui Before CaUi 



fiBicjtf Mwca) 






-TgiLi'-i tr-^-eJ 



{.^BKiB icocej 



;j»ria 









-iP 



Stac* After calh 



iBarf-ggfiHinf no. 



laad-(J'e no 






■*-SP 



nami 



HMOndTypB 



Inpul: 



bjK^ 



CmifKitz 



Use( ID word «»luc (2 tyytesj 

id^rcas of loid-fOe lo^B word painter W 

luune 

arJdin°'is of loa-d-KftHicnt Icwig ward palnber '[■J 

nairiE 

aHrin-« af segtncnt long nvtd pololei C* byMiJ 

User Id word lesuk Q bytes) 

luid-file numbei word ntSuh (2 bytes) 

loail-KSEnciil nurtlbCJ' -waid (esutt (2 bvMSj 



Po»lbl» errors 


11 101 


Scgirtent not fcimtl 


S1104 


FJIe is n Lit a load File 


jno5 


System LoiflcT- is buay 


tIlD7 


Filfi version ift'X 


S1ID9 


SegNu.m ■mji of sctjuetice 


511CA 


Illegal [aid record fcund 


ni&B 


Lod ft xffTjcm is EoKtJgn 


$OC«jf 


ProDOS 16 eifOf 


JDZn 


Meoiofy Managpr error 
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Part liiiTne Sirtlem li>ad«r 






Sftquence of svsoHi 

■OTien, [ht Load ScgmMir By Nunc hmninn i» oiled, ihc rdEaning 

Kqucnizc oT eterlis mznirs. 

1 TTie Syslcm laader gcM iJit load-fiUs ptthnsme ftom the poiAECt 

given Mi (he ftinctiun call, 

2 The Sysicm Lojdef dic-cks the fUe type oEihc icfcicn«d flfc. 

from thie filc'a disk cUfecioiv tntiy. If ll i-l ndi i load KIc isype 
SD3-SBO. eft,sr Silo's is tctuciEed- 

3, IT ll Is » lOTid Tde, the loadei calk PraDDS liS qo op^n [he EUc. If 
ProDOS Id carnnc optn the file, it rccuiru [he appmpriaie error 
code. 

4. After tfie load Rte hii bwn successfully opened by PfoDCis ifi, 
Uie Sysjcm Loider seirdics itie file Toc a sramcnt wjifi the 
speiifed name. If Ilflnds rorc, cimr J (101 is rrlumcd. 

^ . If ihe [(jMf u^^nmi I» round, [he SyEicm Lrantef fioie* ihc 

segmcnE number tl atsD chcn^k.^ [he Palhrumc Tibti? w s« if the 
ipiij (Ifc is lisEcd. If Ihc nie is lisLcd, the loader grts the load lik 
nurabec (ram xhe utile-, if nnl, i1 tJdj a new calxy to the 
PitEiEiame Table. asEijnin^ an tinuwd nJe rmmber in ihc load 
file. If ihejLJmp-Tible-lcHdcd flag in ^itt PiIhnaccLc T?bte is 
FALSE, llw lojdicr Icids tlie Jump Tihle 6ear™;n[ (ii any) Uom 
the inad file md sie[s ihq J u^mp-Tible -loaded dag io True. 
6. Knw (hal \i his Iwnh Ihc Jnad-nie iiumbcf and the ^gmenL 
numbef irf [he tcqucsied segment, ihc Sysrem Luadcr calb tii* 
]jJSd Segment By Number fimdjon 10 load [he segmenL IJ" [tic 
Load Segment By Numb^)' funolon jcnjnns aji errar, Bhc Load 
Segment By Njme lujidion returns ihc Mmc etio*. I T ihic Load 
Sefinien.[ B>- Numtief ftjnajtm is sucflcsaful , the load Segcn^ai By 
Nime Functifln returns [he toad Tile number, the loid acBinent 
numbfir,. ihe User ID, and ihc ntanng iddrcis ijf (he itiemciry 
btodt in wludi the LiWd !e.sjicnl. was plactid. 
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Unload Segm&nt (SOE) 

This Eunction uiJoids die load segment -eOAtainin^ the spcdfied. 
iiddiess. By usLng Unload Sesnienl, an applLcatitfirt can utiloaiJ a 
i j^in f^r withtjui having (o Irnmv iis load-se,Bis5enl Eiuniber, loii-IJle 
numbei, nsmc nr User ID 

FuncHoT MutiitMr: £0E 

NiKro NOYM: UnloadScg 



Ponamfttou 



Ham* 



StnondlyH 



Input }ddte« in scHmcFLt 

lo'ad-fLle rtumhef 
load -segment nijinber 

Stacli Before Call; 



lOrtH w<nd pDtntei (4 bylCjO 

word EBsuli CJ l>v>es> 
ncinl rciiulL A byl«} 



_iv_ 



,fj6^-j!i ^jLi .','■■■■.■ 



- aaams in &gpmu,'W 



SiacJt After OOh 



p^^gvll?J^ C'^'''"snl;i_ 



I'fvrf ?gflmfvi. f^ 



lotjtf- ^JV nri 



CJwni:? 



-3P 
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Part rihThe system loader 



Po&sibiB errors 

SI 101 Seamen: ncn TDund 

*0<J3K ProPOS l6 crras- 

JOiur Memory Ma.naiter tmst 



Sequence of tventa 

*7icrt ihc Unlfwrf Segmcni fLindipo is called ihe foUcwiiig' 

sequence Of CvcrlAa Dcous. 

1 . nic funglon caJls thr Mcmofv Maftip^r in Jclentlfy Uie memtny 
block CDnnainirvjii [he spefificd afkUpssj [f [he iddress U ncH 
wJ[hJn tn allriciirf d memcf^ block, cnor illOt is re;gmed 

2, If [he mcmtMv bloti; u fcsumd, LtK fll nciian uses Ihc m(wrii5J>' 
ttindU; tewrretl b^ LfK Memory M3,n3grr H*: iJnd the blutk's User 
»>, ]i [ben scans (Jie Mtmory Scgme'][ Tibfe Ew m cnisy wlih 
Ihat Ussr lU and hindl? If ntnuch cntjy b found, rcror SllQi u 
relumed. 

i- if thi? M*raici[y ScBmeni Table enliy \s fouTKi, Che fiircrion dcti 
one ciE EwD [hlng^i 

■. If [hf Manor ^8" WfiC "J's-tit cn[ry lefeis lo any seRmenl 
Dthci itijn ii Jump Table iegnxm, the tuncuan eiiracts [hp 
iMd-fUc number and laad-segmaTI rufflfer from the entfy 

t If [br Mcmaiy Seajncnl Table -Jrrtfy refcra [□ a Jv;np Table 
WsmenE, [he funolon emiatti [he Loj(3--nie rtjmbcj- ajid losd- 
se-amcnc rvumber an the Jur»p Table erUry M (he adiiraiss 
SptdJied in fhe TutiirU-uii tail. 

■1. The EiintnJun [hen calls Cie Cnlcid S¥9rTwn[ By Number funnJon 
IQ unload the segmcnL 

The tijipuis of rhu; function floid-Jllc nunubcr, IraU-wgcticni 
niimbw, and Use EI1> an be used a^ input) m nthcr System lotdti 
funcliana aicJi m Load Scj^cni Qy rJumtjcf, 



I 



Get load 5«gm«iil Info iiof) 

Ttii! fiirvction iFlumi [he Memnfy Sejimeiil Table «11Ty 
torrtSporidlrift tn the specified Cby nurtlbert load Kgtnent. 

FincHor^ NumbAr $0F 

McKna NdTMiL Get LoadSo^ I nf d 



Parametefft 



Hor 



SlMandTriH 



lupat Umt id 

loid-JUe nkiiubsr 
load-scgmeni nurmbe-r 
iddrrs of user buEfei' 
Outpiui <FL]le<l user buITefJ 

Stfldi BeToiv CaiU 



wnrtt vahjc (Z bjies) 
wocd vihie (2 byies) 
word value iZ tyies) 

; wofd poLiuer (A byica) 



Ws-W 



teptf-'iig .f o 



taarf.MQrTian*' r%a^ 



oua'isu of 



*-sr 



Stack AAet Cadi 

\^SP 



P9&ibls errgn 

SUOl Baiiy noi fouiici 

illOS Symero Loader is busy 

SOflwe ProDOS l6 exrar 

M^TK Memory- Manager error 
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SequencB of aventi. 

Wticn Ihc Gel Load Segfirtefis Info Airtction is alicd, ihc IbllowinB 

1. Tlie Memoi7 Segmtnl Table is searched Int ihe spedPied fifiiiy. If 
the eniry ii ooi faunel. cctcm JIIO] Is renirti^. 

2.. If the enl/y J} found, ihc i:i:inLcnt$ cT the enliy CKUCBpl for Hx tick 
puintcra) ane H»pled tntc ihc itser bufTEr. 
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G«IUsmlD(SlO) 

This fiuKfiofi natums ibe Usa 13 jjsociitcd wi* ihe s-petifed 
pilhiuow. A conuQllilnB prugfHm can use iWs FuncMion to 
tlciominc whMJier ii can rciun ifi appliaiion w nuiEl pecfafm in 

lAiliil Icid 

FuncllCP Humb*r1]0 

Mocra Nom*: eetyaetlD 



PaiametDrs 



Hvra 



SbadMtlyptt 



Input sdAiexi at piihname 

Ovtput Use lO 

^cwJi Bcl'ur« Call 



long wprd pninKt (■^ bj'iw) 



peVIQi-fljr^rilar'ilt 



(tasufi ibocgj 






■iP 



&tadc AJ^er Calli 



^ 



(jftw-q. 



t.- 



2dO 



P<jrt llhTT* Svit^m Lnfldar 



flf 



Poss[bl9 9fron 



iu6i 

S1105 



Hniry aai (aiijd 
Syafcm Lmder is buJy 
ProlXH 16 amr 
Memory Msnagci cccor 



Sttquenca of ev«nlt 

When ihe Get User ID AincHofl is caDed, ibc M^iwing Kqij«noe of 
events occui'^. 

1 . Th^ s>-!iem kMder staithcs the Pailmame Table for tte 
spedlied paihjiajTie, IFlhe input paihname is i pafiia] paOmamc 
and ,'iails wUh a prtfir numbet Olhtr ihan 1^ nr 2^, dc te 
ejipandfcf [□ j Tli[J ptthnimi; brfoF Ote sem^. 

2. If it finds a initch, cbc- leader r^iurm ihe Uwr ID' from ttia.t etHfy 

In tlu FaOaainc Table. 
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G«tPcrmnama($11> 

■mis liinalon reiums ihe putirwmc associated wiih ihe spedficd 
Usci lD. f roDOS 16 uses ihl* tail uj set the appliaiJon preliK CI/> 
ff* 1 proKEam Lhai La restarted from mtmory. 

Funciion NumtMR $11. 

MqeFO Horn*: CftriPathnlmc 



I 



Pommetai! 


Narrw 


sif* ana Typ* 


Input Use/ ID 


wOnJ vjlue & bjfflS) 


PdU? nuimtirr 


wortf vahic U bites} 


Oulpul A-diirca^ of puhnicrir 


tong word rejuh, (-4 byics) 


Siadf Befora CalL 




□rffvlOul conten-s 






fjBiu't *fX>;eJ 




LlwiD 




iKKl-rj'o riii'ntef 






'4-»P 




Sudt Aft^r Calb 




pieuiDiis cDfiienls 











-w 



a-is 
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Sequancs ol evervft 

* Mote.- "niis fciKtion is cJeslgnw) 'o wppol Uie opUonj ps ovided 
in the ProDOS ]6 QUIT Jiintljon. The iq-uit /kg in thJa dli 
corresponds ra ih« J!ag leorii parameier Iji the ProlXJS 16 
□□IT call Only bJls 14 and 1^ □[ the Jlag a^ aJgnl^canl: IT bit 
IS l5 sei. the quJEiIng pmgram wi99ie& contcot lo reium lo It 
evcfituatly; if bii L4 Ls sft, ihe pragc^^ -is murtablc. See [fac 
deHnE^CEon or ihe n«9iafl Rim^cion in this ^iaptet. 

Wbirn Ihf lj«?i Shutdawn Ainrdion Is called, Ihc faliowlng ^tqu^nc^e 
of evaiis occurs. 

1. Tlw Si^siem las-ist cbedts ihe specitlHid l^ser TD !r li is sero, fti« 
loidler j^unnea ii is [he curmu lUs lO C - value a[ USEKID 
globil i^Hable) En any fas«. loifler jgeioKA (by senLng [s urO'] 
alL vjJucs in [he AuiID fltld of Ihc Uacr ID 

2, Hk lijidei cSecks ihe v^ije oi lJw quit (tig 

a. If (he quil (lag is zero, ihc Mtmory Manager dli|>:i;E!' 
(permjfientfy deallocaies) i[[ memory blocks wlih ihe 
Kpcdfied Usee ID. Tlic Sy.stc:i]i Loader thon. calls ^ Ocajnup 
rouLlriie to (AJrge !he loader's iraenwl lables or iU feferentes to 
thai User ID. The User ID itEclT is tickHcd sa Ihat th? sysumi no 
]ong«t recognlwe It 

In ihis CMC Ehe appEicjllon Is <x5mple[e]y gone . Ii cannot be 
n^tartcd &om memtny at tmld^Jy reloaded, 

b If Ihc qitLt flag is $8000 Cbn 15 Bd In I], the J.tcmnry STanage* 
puTgfs [tCTiporTjnly jteiHocates) all memcty MtidiJ wiili die 
spcdiJcd User !D, The System Ijua^ci's Iniernal lables For ihat 
Umi' id, li^duding ihc P^Lhnamc Ta,bLc ciUry, lumain. inIacL 

In ihis case i^e ippHcttiaa c^r be ir^loadf cl quiffely but ii 
cannot be rc5larted Irom memcry. 

c. iTihE quil nag has juvf other vilie, the hternary Manager 

n disfxaes a]] hindts 'fori«;tponding lo ffynamit segments wJih 

iJic spedfipBd User ID 

■*itb ihsl ILlBCf ID 

D pMFjffi all diher Urazks with thu User ID 

In iddJLJaii, ihe System Loidcr icmavct ill entiu» for Hat 
Ussi ]D rtom [he Jump Tabic DliEOiny. 



The appJicatian is now IF* 9 dtwmant scale— discDEineaed btn 
ncK sonc. li may be resuxietind ven' qiildtlj- by ihe SyMcm 
l-crader because all it» taik aeigniEifl^ iie still >n mcmnry. 
Once anif cF ill Slicic 9i2Rincn[Z. is puJffed ijy the Menwry 
Manager, JiouMm'er. ihc pfogtam u iiuly losi and miist be 
leloaded from disli if ii Lj needed ipin. 
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Jump Table Load 

TTiia fijncijon i; oUikC tiy ici unSooded Jusap Tal>l(! vniTf It order lo 
load a dynamic lead segmcnL B«9dd«$ the ruroJon call, [he 

urtfoadcd Jump TjbOe enuy dndjdca the lonJ-fUe rumbw ^nd ]oad- 
scjsment number of ihe dyjumJc ^gmeni [q be Inadcd. The Jump 
TibljE if destTfbed In CJiiplci 15. 

funcllar Humb^r: nonr: 



Paramtfftri 



Nam* 



Sto* and lypa 



input Usee ID 

load-file number 
Ibad-acjjnKmJ number 
lOlil^acHmcnl dITep;! 

OutlHil Cnnne) 

Slack Bclon Calk 

_prewi&Ji ^ariio.-its 



WMd Value (Z byCcs) 

wufd value S byies) 
ward vahje Ci bjies) 
long wwd raJuc (4 byies) 



I 



IJSOfP 



liMtl'-'i'i^ Jiti 



[pttf-wJismpn? rg. 



-kxid-iegmeril affSDl 



■SP 



Suck After CalL 

praviQus conlBRli I 

• /VD;e.- Brciuse ihia function is never tilled directly by » 
contrdllin^ pfo^ram, [he program reed nm know whii 
pann^^i^r^ il requires. 



PoMlble erroEs 

$1101 Segment ncit fvunii 

11104 File Is not a bid Bk 

$n05 System Loader is busy 

SOOtoe PM[iO!i 1( errof 

$OZn M^niniy MEnigrr irrrfir 



Sequence of events 

''Jt'hijn |he Jump Tabic Load fiincli™! u called, ite foll«ft'Ltlg. 

1 . The fortoioii alls [he Load Segment By Number funaion. using 
Ihe loafl-Ele mimlKr ajui Icad-scgmEnl number ill [he Jump 
Tabic cnUy. If [he Loid SeglTiefLr By Number furctinr rctiima Attf 
ciroiT. the System Loader tOnsidcrS il * ftisl erroi and calls Ihe 
Srsiecn Pailwe Mjinaa^i, 

2. If the Loati Scsencnc By Wumber fiinalmi .aicoessftilty Joads die 
ae^nwtii, ihte Jump 'I'jble Lciad &jnciion diitiEcs die Jump Table 
cnlry (n its Snad^ stale: iL irplaoa lllG JSl. l& [hC: Jump Tabic 
LCidEu;nai<m aldl a JWL 10 Ihfl Jbaotiite addmsaof the refcreiwe 
Ln li>c lust-Eoided .scj^mcnL 

5. "The Funcitnn Eruisf^rs wrfMroI la Ihe ttidKSS of [he reference. 
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Port lll:"niB Systam Ladder 



Clwanup 

TJiis- wiulinc ix usf d lo free idditlonal m^tiioiY wheri rrecdcd. IL 
itaru ihr S^tcm Lojdef'S- iilKmil [able and icmoves all entries lha[ 
reference purgttt or tXapu^d segments. 

• No!e: Qc-causc ihis fuinttitjn i* nei'ST cillcd lilrcciiy by a 
ccmtrfjlling program, the program need f\<>i know what 
parameter?; J[ requtrea. 

Funcilon Numbai; none 

Macro Nam*; nunc 



Paiwi«l«r» 



Henm 



Sli> and Tyip* 



Input Usfr ID 

Oulpill (nanc) 

StfKk Before Colti 



woid valLtc (2 hym^'i 






"SP 



Stafl: After Call: 



Possible errori 

{Eiancj 



Sequence of «v«nrs 

When the acanup rouilne is called, ihe Fallowing set[uence ol 

rwcnis arcura. 

1 . If i3ie ipedr>ed Use« IP Ls ft 

X. The SyMem Loader scuts all snuia in ihc Memcry Segmenl 
Tabic. 

b . All dynamic segnKni^ loi all U&er ID'^ ace pur^d. 

2, irthe spedHcd User ID Ls noji^ero-- 

1. The Sys[eiTi Loitdef Jeafts all cntriei' In ftic Memory Segratni 
Tabic xvjlh ihal EJscr ID. 

b. All Icid i^gmeiYLS (bodi dyi:iamic ond'sutiO iTdr thai Vxr ID 
ire puiged- 

c. All entries In Ihc Mcmary Segment Tihic, Jump Tlble 
directorsr, md Pi^uuime Table Tof ihit Uwr ID ate deleied 
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Appendixes 




Appendix A 

ProDOS 16 File Organization 



Thi* appendix describes in dctnil how PkjDQS 16 aores dtu on 

dJjks. For miTtSI jppllH:aUanL, the Dperalirg ^yswrti imulalcs you 
FH5m ihLi level of ftetiit, Mowevef, you musL use [his LnJomiJtion iE, 
[□[■ cuanifdt. ci'iu »rtrvi: to 

n LiH [he Tiles m i dLreoo/y 

□ topy a .apUK RJe wllhotit IncreasinE The file's iiss 

D compare rwo sparse fites 

Keep Jn mind thai PraDOS & and ProDOS 16 ha™ ktential fik 
Bimrtures. The LtvfofmsiJon prescnffid here applies equifly to bfltt 
S'l'sCemi 

This appoidit fijal cxfrllins tfte wgsnlralkin of informaiion on 
vcilum«. New, il shows the fcrmal artd organlzatlnn of vatuEiw 
dirctlDrics, subdirinofies, and the various sla^e^ Of slindafd files. 
FirialLy il preacnts a kL of -diageutiS showing the farmils uf 
individual l:»ej<iec and eruv fields. 

♦ t^OIC: Ifl this, appcndijt, format lefer* [O (h^; nrranBcmCUL oE 
informatian (such a& header?, pointera and data) wicliin a File. 
Organlstituifi refccs tn the manner in which a single liEc it MoMd 
□n di^, in lermi Of bldJviduJll 512-bylE blocks. 



ZSl 



Z» 



Organlzallon of Inform oHon cm a volume 

"Then a volume Is rormatred for use with PidDOS i6. m wf Fim e 
paniticined Inla an aiiay of IrtCkS srtd 3ei"tO«- In accessing i 
vulume, FroIX^S 36 lequcsH nal a tiack and sccEqe, buE :) kigi>^ 
Kack from the- device ca rreipomling [o thai vniumc. That dcricc'i 
rtriver irtnslaTM ihe requesred blwi mimbcr Lnco ihc proper [f»dt 
acid seaor ruimbcc; Lhc phj-scaJ lariCaOfl Of if^rrhfniiiuon an a 
valumc is imirapOiIint 10 Pr&DOS 16 und to an application lhi[ UJa 
PfoDOS IS TWs appendix disoisscs ihe Or^ rtiUCiOfl Ctf 
infannalian un i voLu me ifl t^rrtis of LnjjJca] blodts, rvcl Irt-du. and 
sect ore. 

When [lE vcJunse is fnntaiied, InTDmuiicm needed by PmDOS 1< 
IB piirai in s.pedRo logical blocks, Stankia with the Gesl WmJi: 
(JUodc 0). A loidtr proEram is plaircd in blocks Cs *nd. 1 nf the 
volume, ttife pfogram enables ProEXlS 15 Car PnjDOS 8) lo be 
boolcd from lhc vulumc. Block 2 oF iJlC volume is the key blod 
((he firs Mock} of itie vciumc dircciniy ti\t, 11 i^nialns desciiptiDM^ 
□E Cmd paintcn loj ill the Fil*» Iri iht volume directory The 
m fid m e diretJorj' occupies a numbcj' cif onsrciiii™^ hliicka, 
lyplicallv Ibur, and l& immccliitclv rollnwccl by the ■wvhiaa bli 
iiLa|i, which jctonli whe^f eich block on xtv volume is used a 
UKU^d. Tlig I'nlume bit ma p t>Li:xLpLc& ctinscculive blocts, OOe fct 
every A,C96 blcdu^ or fiaaidn iherecif, on [he volume. Ibc rsst of 
lhc bloelc* ort ihe dwk CDfitaifl ^ahiHreuary fi!e infannition, 
standard fiie information, cir arc empty. Tlie flMl blocks of 1 
vi>]ijrn« loot soiiwJiing tike Figure A-1. 
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S=r 



Fii- -k ; 



^i^ 



^ 



ao.ru n 

^'alums' 

Ofpc'nm 

{loit tih:ck) 



-^^ -^^ -r^ 



I'llMCC' 



voli.i'nri 
IIIU1 »g:- 



::inQrHai 



Flgur* A-l 

3lcK:k orgi^nlsiillu^ Ql C VOlurr« 




The precise format of (he VOlufrtr dJjCTrtoiy, vokuiic hit map, 
siitjdireciofy rJes and atandaid dUes aje «pls4ned In ihe folLowijig 
MctiDoe, 



Format ond organfzdtion of directory flies 

The format and organjaaijur oi' [he infarmailon cjcmialned in. 
t'ofu-HK dicienory and lubdlreaory Tiles \i quite slmilir. Each 
consists dT a key block followed by 2Em or more blraA,^ lOf iiMltkinal 
liij'e'Ci'.iry infoimatiorL The fields In a direcw>ry's fccy hlodc ate: 

n 1 pninler lo the fiexi Wdck in the du^Owy 

□ leader thai describes ihe diiedory 

□ B number of fDe entries descritwng, and painticiB tfl, ihfl JHes in 
thai direciOry 

ti zeru uc ntcre- unused bytes 

The field* irt Subs«^cnt tnonkey) blocks iil a diiCctoiy arc: 

n pointers lo the pfrecedlng and succeaiin^ blocks in l>*e idiitclnry 

a a fiUrtiber of enliits tJcstftblng,. and ptiinLing lo, the Jjies in Jha) 
dircaory 

D Mio ar mpre udused bytes 

'[Tie foraiat nf a dat^ctury flic ts reprEjenttd jn FilgU-re A-Z. 



trvysiocii 



Anr liDct 



n 


■< ■■-■< 

*■ "' P- 


c-:>fv!flr 


-« •■ 




coifei 


pcr.lDi 


pcuriiei 


Q 


hBl][3l]r 


tfa entiy 


Ulei&iliv 


rasflnrfv 


1Id ievIiv 


l^srrtri' 


rriDr* 

Enl'M 


■nore 
anniQE 


irlCfH 
Qr>l|lai 


TMsrrliv 


tilBsnIiv 
wVoSrf 


nW'i'ifv 







FIflUra A'3 

D*Qctory ills rormcii arrf oroanteatlcin 
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App^ndUes 



Appatvflc Ai PraDOS 16 Flia argor^otion 
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2Sa 



A.fipanQIxu 



Tbc hcider is iTw Mine tergih 1! aH other ent^H Jn a dirccinry Hie, 
'J^ only diffcience bclwccii i. volymc dlrcciary Rlc arid a 
aubdirecLory File Ls Jn (he licadcr Eoftnit 



Pointer ftfllcb 

The flfsl fwir ■b^tGs uf each bltjdi uaed by ] dtrectory fit carwain 
pDtnlcra lo ttte pnwJing »fid siiciJicdJns Woths in [he dirtdofy 
fil*, iiespetth,c]y. Each poixiLcr is i [wCi.byK Ingioi hlndi 
number — ]ow-OC<te» !>VW fi>st. hLfth-DcdcE byI4 second. The iory 

bEnck of a directary file his no prewrfing block; its fiiaE poifltec is 
ftra. Likewlfa, [he Ish block in a diiEOcry file has no smxesx^: ii* 
K^I^nd pointer Is Tera 

♦ Afoie,- The blotk poij^ierij deKfl&eii In ihU appcridlii, which 
hold ttisM iddimsss, are two bylcs Inrtg. All whef PfaDOS 16 
poinlcrs, which huSd memory addresses, arc four bylHsS tong. 
tn eJlhsr caw, PioDOS i6 paLnlcjs aic itwayj stOf?-! with [he 
Inw-Dnder t)y((? Jlni antj [he hi^-nrdct byte LiiL See Chapter j, 
•PraDOS Iti and AppI* 3I0S Memorj;,' 



Volumv directory heaciera 

BlfKk 2 (rf a iTiliirne is chc key blodi at ihii TOlunw'a diredtK^' Oc. 
The vulumc dlrcClory hcadCT is al byie pTLSition jMKM of the fccr 
block. Immcdjalcly fDUowtrg, ihe bliick^ [win poimlRPS. Thinccti 
tieids are cuircntly dcTinai [□ be in 2 vc^luine dtKCiciry 
hcatler: Ihry crJrtLiiri »lt ihe *iw] imrormauon about ihil; voliime 
Figure A-i LlliisJratcs Ihe formiL of a vDlumc ditccuiify htadcr, 
PoUo'iuina ngute A-J Is- a descriptinn a/ each of its RckLs. 



filOCM 

a 
1 
1 
i 

& 

h 



uorago -1^^ nqrT»°_ianairi 



Me_name 



Lw^th 



13 

'i' 
ic 

ID 
1E 
.IF 
30 
91 
23 
23 

2? 
7S 



t 



0*tne date 



efflatsjlme 



min version 



ei^Ty lnnJ^K 



antriei par_l;ieicl' 



fiio_ count 



bif.map painiOT - 3 bftet 



lolal Bloea - Sbytei 






4 2bYtB4 

1 tvio 
r cyiB 

I tTbiB 

- I byres 



The valLme directory h«ad«f 

«l£ni3g*_tTpa tBxJ naiTi*Jwi>g<ti Cl byte* Two fbur-bJl Cnibble) 

n<;l!fj are padinl taLo this hjic. A ualui^ of J P In ihe Wgh-onler 
nibble {ator4qw_typB) identifies ihe airteni block as the key 
Wocfc of a valutnc dlrconiy TLle, TTie Jow-urder ribbtc CDntains ihe 
]cciath at \he vtllume'a tUmc l>cc the f ile_name HeJd, bclHTw). 
■|Iie vahte a( nam&_len9th can be dlirt^ by a CHAHSE_PATH 
all 

ni«_nnm» ^ bvl*»^ The ijrst n bytes ol ihls TiKld, when! n is the 
vaJue of njiiii!_l»ngch. LTititain, [he volume's name. This name 
mu.?t tiMirwm Id ihe file nime {volunw mtiKi} Synlas cuplaincd in 
Cha pier 2. Tbc fiame ices not bejjLti with Ihc sJash that Utsujlly 
ptcocdts volume ramcs. This f^lj carl ix Chlflgpd by the 
GHANGE_PflTHC2j. 

r»Mfv*d (fi Aytu;: Sesenred Tcf fuEUK «HpardLOEi of ibo GIc 

svalem. 
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CFKitoi.tiat* (.2 bytes): The date on whidi Bhis volu-me waji 
tnliJaliznd. Tbe faimat (jf ihcic bytes is dcscriLtd utwJei' ''iieiiji^ 
ard Eii[i>' rietJa," Ukt in [hts appendix. 

civala_lhTia i(2 bYtssJr The lime al which this vohraft wft3 
irtiUali/ed. Tht fojisjit or thew bytes Is de^critiefJ undor iiejdtr 
ayui ExiLry Fislds,'' latm" in iTiit appendix. 

wnlon C byte): The Cite system werskm number of ProDOS 6 or 

PtaI>GS 16 under whiLh the- Hie pointeJ tu by [hts cnlry waj cmirfd. 
l^ls byie slluw^ newn] venloii,^ nf l-'iciDOS 1£ ui dctcniUnc Ihc 
[□nnil at ihc file, md adjust [htji irtlCrpieuiiiai pftxesfi 
accacdJirgLy. Fac traDOS lb, ueraiaa. > 0. 

* !Vote. Versicrt in ihiB sense refers «o the /Ife yaffl™ vrrsinn 
only. At picscnl, i.lL PjaDOS □pcn.ting sySitcins use the ssm; 
■ fiSe system ar4 iheiefpre have the wme fife sy.'item ^-cisimi 
number (.0). In pariinjiit, dhe file jyilCTn version number b 
uiiselitcd Vy th(: ^rp^ram vcifJtin nrLimbcr returned by \hi 
GET_VCHaiOWcilll. 

mln_v«il«i: Reserved Ft)c Tuiure use- For ProDOS Id, It «s 0. 

acc«» (1 bYte}: Dptcrcctincs wbEthcr ttu.^ v-nlumc dinrcloiy c^n 
be reatl, v.Ti[[en. (Jesiruycd, ur nsnamed. Tliu FtjfTnai t^rihis fteLd l* 
dcsoibcd ujidcr 'Header axid Ertlry Fields,' in this jp}iciLdiK. 

4nlrv_l«f^9lt> n b¥t»)r Tlic Icnalh in bttts oTc^cL cnliy In Lhis 
dliector> The volume dicectory header itself \s of this lensth. ^'or 
ProDOS 16, ani.ry_letigi:n » S27. 

«iiiirtn_p«r_Upc)t H b/fel; Hie number cr entries ilu.1 bee stoiti 
in ddi bfnck ai the diimay Itlc. Fai; PinDOS l£, i 

•fttr-i«a._pgi_t']ocJt - SOD, 

FIH.caunl (2 bylea): The mimbPT nf atiivc file entticji tn Lhls 
dinjciOfy flic. Art iCtive file is une *tiose storaqe^tiypB l» net 0, 
Fiaiijc A-5- show.'s the farntat nf Tile ejilrics. 

WI_map_pokl1»r (2 CylflSj: The bloci addtess oF the fiist blrxk d 
the vci(u.me's b't m^p 'iTic bit map occupies <CJisecutive bloci(s, 
□nc far eTciry 4|(y>5 blixks tor EnnaJon tbeicoO en the ■volume. Yfju 
can c-Jilculaie the ntimbei ciT blocks in the bit cnap using liie 
tDtai_tiiocka finld, dcsrirtbcd below. 

The bat map his- one bli fnir each binck an itie volume: a va.luc of 1 
tneitis ilie blixk I& free; niearui ii is in use. IF Jm number efbkiclu 
used by sli files on lb£^ vnlumc ii not the Jiainc as the number 
Kciirtded let [lie bit D^ap. ihe dli«iiury .^Lniciurc af tine voltime hu 

rolnl_bl*ela (£ byres): The tutal rumbcr rf blotks oa rht voliimc 



2-56 



AppSAalKU 






SubdlrtcforY h«ad*7» 

The liey bLotl; ijf tveiy subdlreOOry file is patnicd H> by an oiliy in n 
pafcra liirectDty; f"' exjfnple, by an entry 0% i vdume diredoiy 
[Figure A-2>. A subdireaojy's header bc-gins aL byre position JOOCM 
oF the key Wock nf ihai subdumoiy fae, ImmediitcJy /oHowlne the 
iwia pDintera 

In Toimal, a subdlrtrtoiy hcjder Is quite similar to i voliimc 
direaoiv hesilcr ianiy its lui rhtec iielttj are diffctentJ. A 
ajbdircctory headec has fDuiteen Tields; ihosc fields cantain lU ihe 
Tttd LiiiowiiitiOn about ihit subdiiettory, Figure A-^ iJlliM«(ft? ll^ 
fornui of a Mb<Utt;aoiT hcider. A descripUon of il] the iiqids in 
t^ tkeitder (dhrm the Piguie. 



Ay4Aef 

■lock 




fMf 
Itng'h 


Q 
1 


D^...r..i 




2 


'■".iFiV.-r 




J 


srDia^s ii.ea|f>3rT* lei,a'h 


Itj^B 


13 


5 1'le_name jjsSlSui^oa 


11^ ""1 
'^f aM*rvBd? -SfJBSrras 


It: 


creat* ■rrnre 


3bvl-Ji 


IE 
IF 


crea'S." '■'n 


2 tiy-les 


20 


vorsim 


1 D'fle 


31 


mln viOriifiri 


1 bvte 


£2 


act:a%% 


1 b^e 


2J 


B-nirv !*ii^rh 


1 bvlB 


ia 


«niriB-s :iar rnock 


1 bi*B 


!5 
2a 


f« count 


? o/r>Bi 


2J 
26 


panen* ponlar 


3b/tep 


2? 


pa-(.a,^' gnlry nufniipr 


1 bvte 


2A 


oare^r e-mrv lenan^ 


1 tjvtg 



Hgttr* A-4 

Iha lubdiroctofy header 
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%\etaoaJypB and nom»_l»niHl1' t>V©); Two fmir-tiit CnsbMe> 
Fields arc patked imo this hyie, A value <>r JE In [be high-orffer 
lUbWe [jtotagetypej idcfitifics ihe curnjill block 3s ihc ktf 
block nf a SutkJirecCtwy flit The iLiw-otdct rihbJc toiltims Uic 
tenftiJn nf ihc subcbr-ef lury's name Csee ihe f i lg:_/iflnie fLclil, 
belamj, Ttic viJiie Of namp^lFngrh an be chanEed by S 
CHJWGE_PAT}i tatL. 

IQp_nQm* CIS Dv+esl: The fusi rtiJrtifi_ie>ig'h hylc» oF ihis Field 
(.[jrltSJfi Ifie subdJrcctafy'S lume. This name muS[ oonfarm la ihe 
rdc name fyniax e^ipliinqd ui Ctiipiei 2. ThJs field can te fhingcd 

by [he CHAHGE_PATK Clll. 

ntwwd ^ t^yUy: Rts£ivfil For (maim uparuiDn of Itie I^k 
system. 

ci*aia_dala m byloa): The date on which this ^ubdireciary vw. 
aeascd- The fcrnui of [hcie by[es Is described urwiei 'HeiiiJer and 
EnUy Frtldi," laser In LhL? appendix. 

CT*al>.1lrn« (2 byfes); The lime 31. which this subdJiCT.Hirr was- 
crcaied. The kirnui -oF jT«5e hirtcs u dcstiibed unde* 'Hcjdcr and 

tvfury Fields,' later in [his ippendx. 

v*n4m (1 bv'e'!!: 'JTk ni? system version number of Pf^DCi5 8 or 
ProDOS llS under which ihe Tile pointed lo by l^i" cnlO' **' creattd 
Thu byte a,lb«S rtfiwet 've«»nns ef PraDOS Ift lu deieinimc the 
roTRiilt or Ihe RCc, and adjust Lhelr irlEetpreiatlrm procEascs 
icci>iiling]y. Fu" ProDOS Ifi, uetaion " O. 

♦ jVaf4?: Vcralori in ill I* se^iuc fefers to ihc /Ht fynicm w;rsLtni 
only Ai prp5cnl, all PrciDOS optrailna, systems use [he sami: 
file sysieni and ihpjcfa»r hsvc ihc same /lie ^ysicm versitin 
number [OJ. in plrlicijlw, the fj!e syslcm vcrSiOfi fiumhcr tt 
lirirela[ed lt> tht: program version, fbamber returned tay [he 
Gbi_vehSi<]K caJL 

m1n_V<flJ0n SI bvtek Tlie minimum vcraiOn numbei' of PraDOS B 
iir Pfi*DOS 1^ Uial can access (he infurraaiinn in this file Thi* 1)1.1* 
alLdwa oldEr vcJSintis oF PidDOS 3 and FrjtXjS l6 to dcLcimJnc 
mhelhcr ihcy can aCW.M iwwcr HIpes. Foe ProDOS 1^, 

rnin vfijriiCir " 0. 

a£c«M {1 byt*); DeieiTnines whether [his subdipectory can 't»e 
[f-id, written, cfcstmycd, at irnanuMJ, and whcihEf lIk file needi tg 
be hacked up. Tlie fyrffiSt oS this tSelrl is described undCJ 'Heatlcr 
ard Fniry FJdds,' in this appcnJui A stJhdireaor/'s icous byi£ 
can be changcJ Ly [he S£T_FrLE_iHFa and 

CLEflB anCKOP BIT caUs. 



in 



«nlEV,lwiglh b¥fo>i Tue lenjfLh in bytes nf each wiwy jfi thiJ 
^nbdire-nory, rhe iubdJreaoiy header ItKlE ii of [his length. Fur 
PmDOS 16, •ntry_lBngth " 127. 

•n)H •t_p*f_bl^b f 1 bytfl): The numb^ cJ eiwriea ihal ins stared 

in each blncJi oF the dircdoiy file For PioDOS 16, 

e-r.tci.ea_pet_bLDcl5 « $00. 

IHb^cou^I' {2 bytte): Tlie number of active File ernrics in this 
subdtcclory (ik. An active file Is one wJkbc Btfiraqt_typff is 
rint 0. Set Tlie EaiEiiis' for more Lnfarcnatlon abouc file enlnes, 

par0nl_pDlrlw C! bylW): The block adtlresa of jiK difCCtOiy file 
Wock thai cantains ihe entry for this .^ubdiceaotv, This and all 
Mhcr two-byle poinlcn anj stored low-ardcr byte Ilrs, hi^-ortler 
byie 5t;cnnd. 

par*nr_-an)ry_numliar (1 bryt*); TTjc entry niirnber iai this 
jubdircdory within the ijlock Indicated by pacentjaintBr. 

poi»n.L«i Try J«nflitti {1 bytalj The en uy^ length for the 
diegciory [hi[ awji.i thJJ aubduecTcirry file Notft that wilh [hcse last 
[hiBE fields you cart calculate the pjedic poslijon pn a volume of 
this MJbdl fed lory's file entry. For FtdlXJS i6, 
P*renc^entry_l«iigtti - iZ7. 



Fli9»ntri«fi 



Immediately Following the pointers in any Hock rf a dheoofy file 
arc 3. nLirabci ctaithes. The llfst entry in the key btocJt dT a 
illieaiMv Ale ij a hcidef, jjl oihcr entries are rtlc entiies. Each 
entry lias Ilie length spKlficd by ihat d^renor/s entJ:y_liong1:h 
Tielfl, and each )31e cnliy mnlairvs infonnitiDn thai dtioibes, an.d 
polni!* lo, a, ainftlc ^uMirectojy file at Jlandard file_ 

An entry in 1 direcKJfV hie may be actiw of inadcvc, thai Is, it may 

er miy not dcstiritw 1 file currently in the dtmrtory, U Hlf inatlirE, 
the liisl byte flF (he entry fat.dro^_type and rwRB_ length) 
ha£ ihc value lero. 

The rnaaimum number of ertries, kiduding the header, in a Uack. 

of a tHreaory li n^cnrnied in Ihc entriea^eE_tiJBek feld of 
flHi iJirtdory's header The total number of atii^^e fife entries, nm 
Inclutlinj! die header, is recorded in the filo_oount field of ihai 
diJECtofy's header. 

Plgjre A-5 descnbcs the fomui ofa fifc enny. 
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FWd H 


tlaoyw fi^pHajroTiDjar^ri 


IDVffi- T 
^15tWtM J 

1 byte T 

2 Oy\w L 

3 bvlei. 

2 b'i1''es 

Ibyte 
Ib^'te 
1 QVIO 

3 byfBS 

SbVTBC 


1 

'; 

F 
1Q 

n 
^J 

13 
14 
15 

Ifi 

17 
ia 

11> 

. lA 

1C 
ID 
IE 
IF 
20 
21 
22 
2i 
34 
?S 


f lll-a_name ^ 


rile tvDB 


K©V_E0ln1&r 


QlQck>_iJt*Cl 


" ™f - 


CTeafe.dai-e 


creoTflJil^l* 


ver?,livi 


min ve'jicn 


access 


Ci^K.l^pe - 


fflod.date 


moa.iimfl 


■neader.ocHnfBf - 


Th* tM &rifrv 

*»Ki5«_tvpB CMvd nani»J"nBtl\ (1 b/t5>- Two Fa«f-b[t CniibbW 
fields af^ packcili ma ihis byie Tlie value Ln l3ie h.eh-DrfLfr iTlbWc 
Cat aiB,<3^ type! spficiJlea chc lype of fUe poLrtcd [o &y thu file 
enUy: 

Jl - SffidllnsGlc 
(2 » SipLingJIle 
S - TfEcDlc 
tl - PaiBllaica 

Sccdiirvg. Mplifi^, and tree Rles f^ described under TQimii ind 
Ofgani:iaiibr Of Siindafd Files," in this ippcndix, Tbc inw-otfter 
nibble canabns the lenBth of the fiic's name Csec the f il«_E5aiM 
fcid, bdawX The raliic of nanio_Jengi-h can be changed by i 
CHANGE_PATH calL 





i 



lll»_r»a!T>« (35 bytes): Tl>e fire! name_iengi)i bytes nf this Reltj 
cGnliin Ck ii3e'j name. This name musi confofrn. lO the File name 
syniaji explained in Chapicf 2. This fidd cm be dungEd (if ttw 

ChAKGE_PATH Ellj. 

f""_lyp» i 1 bvte): A dcsoipiftr oT ihe intcmai faimat of the filt 
Table A-1 Cat tlie ertd uf ihi» appcndii) is a list of the ciiTiemly 
dfifified valuei of tiii? tyte- 

«*lf_polnl*r (2 DvtOSj; The Wotk sddiess oF; 

a the nutter Ind^a block (ir the flfc is a tree Jlle] 

□ Ihc Ln*k^ block (if line file :s a sapliii^ fJc) 

D tiia Jail hEnck (If iha tils ii a tcxdling file) 

fafew?l«»_U»d <2 tjytaa); '[lii; icHal number of bfncks icru»lly used 
by Uic file, l-'oi- 1 lubdircdnry file, tfils mdude* (he blotJts 
COfflaining subdlicaofv ififormjiion. but not ihc bioclti In ihe flics 
poLrulcd to. Fay k slandard file, this IndudCS boill in/onnatiaiiil 
tiiaiAs (indCB blncin) and dsta Hocki. Sec 'Foratil and 
Orgamiiation of Sliildaid Files" Ln this ippendwi. 

EOFC3 bytet): .A three.bvi« mieger. towast byte flfii, thw 
icprcscnti ihe ro«l rlLiinhec nf byliii readable fnajn the file. NtJtc 
tJia[ Jo (Jic tisc oJ sp3d-.5c files, KOP may be greater than the number 

uf b/ics atiually ailixaiecl on Lhc diik 

cr«il»_(Iarfl C2 bytes): The dale on whtch itkt fife poinicd: ki try 

thi.^ ■eiitr,- W15 crcited ITie fomtai of these \»ii^ 19 tfeKiibed under 
"Slicadcr and Enuy Wfclda," lata tn this appcntllii. 

w«if»_flri» (2 &yfwj: The liuie lil whjtii the file pomied id try 
Lhj.il Crtlry was cfcilcd. 'Hie fomuL of these iFfUs- Li diiieribcd Jrtdci 
'lleitlcr and Kntrv fields,' litct in ihls ippCndti. 

™ml«i [I byle); The file sysicm vcrarori number of ProDOS B tw 
PraDOS 16 under which the file painted to by this enlry was crtaiciJ. 
"llUa byte aUows newer vcrsicns. oF PtoDOS 15 to dclcimine the 
/ormar of the file, and adpMSt their imtcrpnrUtian prpoesses 
accordingly. For PraDOS 16, uaralon -0. 
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* f^ois- vefsian ifl ihi= seJiK refers iq Uk ^te jjrjr™ ve^Lofl 
□niv At prewnt, ill pralXJS opcnUna sysie^ use ihe Bamc 
(llc\y»Km and therefore hav.. Ihc same nir sy5lem vcfsion 
nurtibcr. -n^ file iysiem vef^icn number is L,Turli[ed id Ok 

pn^srdffl VCRion mmJltf «'t"'ned by Ihe GET^UERSIOS call 

oc P.qDOS If- ihi[ can icces* ihc inlormsaon Jn ihts fJc. This by(e 
^ow* pLder .eraln^ Of PraDOS 9 ^J Pr^iDOS ]6 U> de^imurts 
■^hethci lliey can access newer filc-a. Far Fr..l>QS Ifr. 
niin_vei3i-on "'0- 

OBGM* {1 bvtej: Deicmiiftes whnlBf ihLs EJk on be ceaJ^ 
wTirren, dctirtwcd, « t?™rn«l, ird whether [he fil«^ Meds lo t« 
JMdird up. TTre feirml ^.r This field ts dcKrlbcd urKifi* 'H«dfif 4iv(l 
Entry FLclds,' latcii in ^ ,ppo^di^ IIk value oE this ^eld a^ be 
disflaed by ite SET FiLS_liJFO and ci^Afi_BftCKt]P_B IT 
all.. You cinnol ^tcc Wwln^) a iubdirtKlury llttt conU.ns anf 
fllea_ 

aax_1yp» P fiyhiB}! A genecai-puf pmc fLCld in which in 
airol=taLojl C»n stare iddilional Lnfcrmalion itwu! the ^nlems! 
fomaL oTa rjc. P^r^artLptc, Ihe HrpDOS 8 OkSlC systrm praBn-ii 
uses ttiLs lieW to recoed the load a JtliftM oE i BASIC proe^m w 
binary TJc, or [he record lensih of i icii (ik- 

mod.dal* CZ tvlBsJ; Th* dale nB wtiidi ihe liit CI.f>3E 

upeubnri ifier n WRITE wi* perfcm^d on ihi* Rfc. Th£ f*]fj™i or 

these byic? Ls deacfilKdi tj rwicr "Hei(*Er and EnuT Fwlil^" lusf i" 

4i^ appeodla. -nils fi^d can 1« closed by ih* SEJ_FILE_1[JED 

ca]l 

frt«i_Hr?i« (! 6Vi«); The iLmn ai wliJch ihc Iwi CLOSE □pentlM ^ 

after a ralTE was purrnmicd on this fiJe The formit of lIujse 

byics is ifcscribed uncief "[leader and EnLry Helds," later in ihls 

ipEierdix. -nii* Held can be changed by ihe se^_FILS^INfq 

eali. 

ii«Kl-r_i«lnlw £2 b/i»>: T»™ field is the bl^i address of thej^] 

bloft of ihe dInMnurv dial «*■« ihis File cniiy. ThJs and all twr>fira | 

poinwjs arc SLorcd iOT.-t.rdcr byie iiiss, hJgh^rder byie sscond 



TM»BLoclc 
FllcCoant 



R«n]|jfr.) I 



fiwxfng Q cOvdoiy me 

This ietliaji deals wilJl ihe genera] techniques of rradkig Ham 
durdory rjei, not with the spedficB. ISe ProDCffi \€ calU wch 
■a/hidi these tcduiiques Cln be ImpEcur^fiied *Tt ciplairwil ir 
Chapters 9 and lO. 

BefiMe yoLj can read Brom i dirKtory, ytxi must Iukih the directory^ 

paiJlrUimc. Wjlh the dlf«CCQrr's pathname, you Cin open ihe 
dircdniy lile. md ctiain a rcJ^jieince number Cre/_MU)«) fci ifuc 
open fitf . Before ycu cjn ppjccsb die Gntrle.« In ihr tJiccaciry, you 
must read ihret values ficim dig tUnJtiaiy header: 

□ lenjyh nf each tntry in th<; directOiy (.^ntryjsagth} 

a nurabci a! entries In each black of the dlteat>ry 
(en ; net J? pr_ & fc c W 

O total number of Ulca m the direOory (Ji:e_i:oiiKf) 

L'sin^ the tefcrencc numbef to ideniify ihc illc, read ihe first jjz 
byles fiptn the lile, iaJ luLd a huUer (TlniBBiDck in ihc rolloivir^.g 
ETiimpte), The bulTcj Eonwlna. [Wo tw[5-b\Te jviiniUB, followed by 
the entncE- the flj^t cnLry li the ditecTH^iY header Thr three: vatues 
arc ai pwiiiuns SlF thjough SIJ in Lhe header Cpaiilionj 52,1 
through 125 in iho buffer). In this example, rhese values are 
assigned to lhe variables EntryLangth, EnttieaPerBlock, 
arwt fi letibunc . 



BeaJSl JB.^t*B [RoEHUdiI j 
rhL.Bla[:»i523]; 
TMnHloekiiJfllf 
ThiaBloctlS^SI ' I25E 



i G»t J-ef sren Da r IXT-^ t I 
'ICat dlTtCtai-y IrtQ] 
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Oacc these vHitrs arc kftown, an apptltnaon oji aan ihitmuli Xt^ 
enrtrtes Ln the iMffct, ustng a pninicr CEnt ryP-olnter) ly ihe 
beftiming u[ (he curtcnt cnliy, i covnUirtBlDckBntEiea) ihal 
indicaies the number of envies thit have been exaimned in die 
cuntnl bJock, anda sctond couiiWi; (RctiveEnCriaa) that 
ItKflcaics the number of acUvc cnuics dial have been pfoeesscl 

An entry is lAJvC ind is pKKEEsed ttiily if iL-i Eiisi byia, the 
H!:t>tflijD_typ* and nania_len3th; Is nonzero. A2I entries hjn 
been pracesscd when ActhieEnlries is cqail la FOeCouni If lU the 
erttrics iJl the buffer hive been pmctssed, antl Aait>s£7ilriei d«sn> 

equal fl'jieCbU-ti;, ihcpii Che nen blodt of the clitttcto/v Ls read IrttU Uie 

bufrer, 

:- Ent ryt"r5tli * i«^ i l*Klp titmtoc rni-fyl' 

* [_ jozf IPrap^ro to p^e»«a nntcr i-"! 



I 



utiLln Acti.WaEnEei«* i: Fllvi^^uiic da taqla 

Lt Thl^HlDcklEiitcySQlntEc] *> 405 thnn buglo 

JrocaiiEntry l7hliBlncfeLEnLi^F(HfVLBr I I r 

Aizt3uHEiitrir-» -.- Act IvflEircrii I + ML 

if ■irtiutfaitclo < rileCaunt than 

il HintrktntrlH* - Entrle iPBTB lack 
ttvsn (wgln 
Tbliaiock 

EStlyP*latoi 
■nd 



|;^>ct.ive cntiVI 



tKacH ^rtrlK* tn proeaii! 



ItJiiBBlaok a*no, D= ncx". Dnll 

:- SOU 
!- SQ4 




Gntrji^aLatiiir 

■Bln[il?iitri*K 



:,aa hexc antty In ThiiSlnctf 
^- Blockmtrias. -> SOi 



end J 
ClOS-tiHafNiiml I 



This atjjpriLhm pfoceaaea enc/lM until all expccisil active entiia 
hive been founi ]f the diirctoiy SlftJHUie is tlaiMEed, and ihe end 
□f the dircttoty fiJc- i! Kjched hefore ihc pn>]iei? flttmbcf irf active 
enirls has been found, ihn alftoriihm f»(la. 
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formdtana organization of standard filet 

Eadi active efiii>- in a dbeciorv ^1* points uj the key Hack t(he Tirsi 
Mock:* of a.norher file, which ilseEE ■£ ^iiher a subdltECEorv TlIc cir a 
itanddrd/iSe. ^s ShCuAm bctow, lihe Jiey btodl nf t sianttard file ma^ 
have sevenl ti.'pcs qF InJ-unnatiDn in iL The ntorage_typiB field 
itl ihit file's «nuv mua be a-scd M df lenminc the cofllcnls of lit k^ev 
BIBEs. TRU waion ciplains t^ Cir^afiEzaticn nf |}i« ikrcc slagcs tjf 
sWndand ilte. seedling. sapJirg. and Uee. Tticse am the fiJei In 
whJd] all ptograEiiS and data are Mafcd 

Every b]cidi In a siindird fOc i^ eitfwi a daia blotk or an Jndec 
blfK* Data blodts haine no predeHngd format— ibey conain 
whatei-er In FcjmiitiDn the fite WM aealcd lo hold. Ifidei Uocki, nn 
the-oiJier hind, have a v«ry spedflc fnrrrai-^hcy .consist of 
niM^Ji^g bu( 3-bTie polntcj-s. fiiving Oie CdisJs) adfCiW^ Qf other 
Wcidci (hit make up the rHe, hjithermiMC, Ihft low-order byte of 
ejch pDinfljcr Li in the Eirsl half a! the blwk, wherea* the hJgh-aider 
hue of the ptiLrlEi is In ihc aconrd half or [he block. An iin4et block 
can have up 10 256 pninicrs. so tf J pointer's Irjw-order byic is at 
addiCM n in the trirxJc, ID Wah-nrdcr b>iE is 31 addreH n*-2S6. 

* f^'ote. Delering a file or chifl^ing its logical aixs ■CEOR can allcr 
Ltw CUntcnLs of its Indc, blocks, Scs 'OESTRQV In Chiptef 9 
and ■SHruXJF' in Chapier It). 



(^rowing a tree ma 

The Enllowing satniiio dCmonslratEa ihe growth at a tree lik 1^ a 
volume. This, scisniiio a based ort ihe blucfc allacaiion scticme used 
by PrcDOS I6 on 1 2S0-hi)od( /leaihtc disk ihai «inlajri fnur block* 
of volume duisoofy. an,d one block of -ral umc hit mjp. Laiser 
apaciTV volumes, mijjht have mtwc b[r»clrj nit die volume hii; map, 
hui tine prtJCGiis would be idcntLcal. 

A itummed, but athorwise empty, P^nDOS ]^ valuna: is. used like 
this: 



Blocks 0-] 

Blocks 2-5 
fibck 6 

Blocks 7-27? 



Loader 

Volume Auctsorf 

Volunie bil map 

Unu.scd 
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If ynu npeit a new file of i nnrdiredorf Evpc, 'cnc daiiii bkj* l* 
imnifidtately ^Uocaicd lo :ti»l file. An cnuy is placed in ihc volume 
dJicciojy, and iL jjoints 10 bloclt 7, ihe rtcw niaia block, as- ihe J<e^ 
block For ihe EDcl TTic key tAodt it Indicated bclc™ by an airow. 



I 



gfedcfO-l 


Loailcir 


THKkE Z-5 


Volume dtreclary 


Khrk 6 


Volume bJi m^p 


BkKkT 


rtilU block 


ubctsS-i?? 


Unused 



This is a. sf^dllng flit ii! Iffy btock CHitains up lo ! 12 W« of 
^la. IF yw wriic mou: [han 512 bytes of data, k> iTie file, ihe fde 
onma itiio a bs-pUdk Ulc. As soon is i K<;ond, blodc oF data 
l^ccomcs neccMary. »n Jndca: blbdt is allocs.Md, Jnd il becomes The 
nSe'a k(ry block; this Lndca block oji poini Id up 10 2^ data blflCki 
Ot uses iwD-byw polaier*)- A iccond diia Ww-k (fac rhc daui Hut 
won'i Jli In [tw flrsi cUia hlcdO Is aiao aUwalcd. 

Tlio voluitie now lijoks like ifab: 



Nodes 0-1 


Loide' 


BlodcaJ-^ 


Vnljmt difectory 


Wwit ft 


Vollpme hsl map 


Bludi 7 


DatabhlCkO 


Vloch R 


IndeH bkK^ 


OkKk 9 


Data block 1 


PJoct! 10-273 


Unused 



This ^apEin^ fife fart lipoid up to 2^ data blocks: 12BK of dau- If ihe 

rile becomes iny bigger [hio Tttis, the file gTVUJi ag^m, IhJs lime 
inlo i tree me. A mjstci irsJcs biiXill L5 allocitcd. and ll tKcoinrs 
the /Jki key blutk: Oie mifter index block an fwlnl lo up lu TW 
intlex block-!, md cad: of [hese csd poini to up lu 256 data blocks, 
lade* block € bKXwne* the JJist indci bluck pfilnicd to bj- Lhe mMttr 
iJiden blnck. Imddiiian, i new imicK hlodt is all<x^liSd, arwlinrw 
data block w which h painis. 




App«rMJlK«l 



Hefe^ a ne™ picture of Uie vatimt; 



Blocks 2-5 
Hlock 5 
BltKk. 7 
BUKk i 
BLucb 0^26) 

&k>ck 26; 
Bktck ^66 

Dlcdt.5 Z67-T79 



l.osder 

Volume din^ory 
V<>V!jrie bit map 
Data block 
iadtx blodc 
Dab block; X.3!i9 
Hasier iadcx lihich 
Indu block I 
DjiU block 2JI6 
Unufcd 



Ai dan u wrJlten w [his file, addilional dais blocks and imisx blucks 
aic liiocac^d as needed, up [o a raammum of 129 irtdcx blocks (one 
a EiiiiiSKr ind™ black>, and i2,7Sa dati Woc:(«. For a raaximmn 
Clpadly ot 16,777, 2 1^ bytes of dau Ifl a file. If yov did if^ 
niLillipJicaiioni, you probably noiircd ihal a bite wij ]osl 
samenjJwre. TllE la.'JC byie -of the last bfodr of ihe iaJBCst poMfble file 
cannoi be used bo^^usc EOF amoi ttorcd l<i,777,2]6. If yuu are 
WDndccirtg, hnw such » Ij^ file might fiL rai j small volume sudi u 1 
FletlMe disk, rcfa (o ihc dcsoiptiim of sparae Bits in tbis appefldii, 

This sccuTin shows ihe jskjwiJi of a single fit on an, oitBmlsc 
cmpiy Volume. Thf pioctsfi is a hii moffi coTifusinfi whefi several 
flies arc growing— tir being dsleied^SimulaaneaujJy, However, the 
Wock Uocaikm sciwme a alwayi Uk jiime; when a new blaJt ii 
ntcdcd, ProDOS l6 always allocai&l ihc fiist unii««d blotk in the 
volume hll map, 
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Seedling flies 

A seedlln* file is a atuidifd lilc fril cnntiins flfl more thin S12 dau 
bi'lcs (JO <- EOP *- i^WJ) Tht5 file Is MOfed m one block «1 ihe 
volume,, and Shis dali blodt )s It* fitc's ko" blod(. 

iSe QTffiixiiatiOffl of sudi a sccdJifig fife appears in Figurt; A-fi. 



k0^,li»lnrHr 



jlZb^Bit^ 



Flgura A-A 

Fc«Twt and DrgofiMtion Of a laedllng ffto 

The EUe is calkd a SMdliflft TQc tjccauK ii is ihe smaSlcsi pOMlWe 
PicDOS \6 iuruhid fDc; d moFe Shan 5 12 data byces »re wrincn la 
K Jt gw?ws into a saplifis file, and ih=nee Inio a tree file. 

The ataraga typ* TkW pf a iiieflBCV eiWfy thai pcinlil [0 a 
ACedtlng (U? has Ihc vaJut Jl. 



SapQng flies 

A saplins lile Ji » sUrwtard file [hat {xwualns moce dian 513 and na 
more thm I2SK bytes (5200 -^ EOF <- SaWOO). A aaplJng file 
comprises an indeR blwi and I lo Z56 dsU btc-riCT The irtdftie blod: 
cmuiaa ihe bltjtt addresses cjf the dau blo<*s- Figui* A-7 shows 
the oiganizaiLlO'n. 



"CB/JJOlnl«r- 



J-byfiiMrtlBnte. < 




1300^0^1.5X000 



FiDEm A-7 

FCTFiGt and iOrganllOtiori erf a sopHnQ ni9 

Tbe key block DC £ Sapling filer La iLs ll6t/^ blodi. PcoDOS 16 leuievu 
daLa blocks in tbc fijc b^' fijsl. n±iicviii8 ihcir address^ in the LndcA 
bloclt. 

The 9tDi:age_'Lypa field of a iil^Claij cntiy ibal poinu to d 
npllng (ite hu [t>e vabe £2- 



Tree riles 

A tree file contains mere than ]2gK byie*, and less than l^Mb 
(iiDCOd- V EOP < ilOOOCOOj a Ucg fifc (tonsist! of a master indcit 

tJnck, 1 W 12B indeK b[f>dt5, jnd 1 ro 32,7S8 d*H blocfcS- 'Th'^ 
mastCc index bl'Dck Conlams the addresses of Lbc Lniicx biccks, and 
filch inttex bloclt comaJns the iddreues of up k> 2^ dam Modu. 

The (Mi^anjzalkui of a bi:!; fOc Lj [ihowvi In Picture A-9- 
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Dale 




IndsH 


*Q 
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Ml 
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t 




I-byieocPilSUla ■ 




l'^ 






y' 


r^nla 

:-i^ 






Vtaitar 
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^^_^^-'^ 


Onic 

aioc-i 
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y 






indsa 
^7F 






• 








• 1 
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/^ 










r 




Flgun A-A 

FrtmaT ond □rgcrilialha ' of tJ ff»*Tlw 

The key Wgtk of i tfee Db k iht rmuSMst index blH>ct. By twAIng ^^ 
thK raaMcr Indes blotk, FtoD05 l6 can find Uie addrei3:s of all the 
index blocks; tjy lotting a1 Lhaw blodts, Jl «n Eirwl the itkLresscs ul 
all ihe dau Uoclra. 

The atarfti5«:_l:ype field of a diifCHHy C-ntT.' ihal points to i irec 
njc has ttic vihic $3 

1 


Using stcmdord flai ■ 

/Vn appJicaiiOft prDRrain Operates ihc Min« f>n- ^^ "fif^ ^P™ ^ 
5[andjr(3 rUcs. allhough *C fttQi:a9*_typB inlhe fQc's icntf^ cm 
t>e u^d to distinguish ticiwef n. The Outc. A pjogiam rareli^ reads 
index blocks or arioaies bli^cJii on a woJame: PcuEiOS 16 dci« 
ihai, TTkE program wed only b* OMicemed WJlh ti>ff dita IKJrcd m 
iJiC file, POt with huw ihcy ire storCTl, 

An types of SLand^yd files iie re^d »9 s *;qiieria: cf bytea, mamfcersl 
frfim (O CEQF-lX M eJtpliLncd id Chapter 1. 
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Sparse FEles 

A ipiisc lile Ls I siplinB rjr lice file Ln wtii^Ji the ritfmber of dala 
bytos Out an be fe*d from ttte fit cutccds iJic nurr^bcr d" bytes 
ptiyjjically $IOEcd in ihc daEa blrxika alEcjc^ited m (h*^ fUe. PrtrDOS 1& 
ttnplcmcRis spicsc /Qes by alEotaiing only tiicee d^[a bloclta ihiLC 
ha.vi€ had dat^ WTiiien. to them, as well ^ tiie Index blodu needed to 
puin[ va ihcm 

Foe ■ejajnfJc, jrou can dcflnn a fOe whose EOl^ Is 1 tlK, lh»[ uMi Ortly 
three hLDdis or the vrJuaie. and ihai has only ibur byiea .mF data 
wrinrn [d jL Hcfcc fo figure A-9 durlne ?hi* iollCwing CKplinaEinin. 

1 . Lf yiAj cieatE 1 Sic uiih an EOF cf iO^ ProtXW 16 allocates only 

Ihe key bictfk C* dara block) for a sccdllnjj file, and fEb it wjy^ nuiJ 
chacaclcrTi CA.SCII SOO). 

2. if vou ihen 3c[ [Sc EOF and Ei>Liik Lo pa^itlnn SC^S, and wrlie Four 
bylCB, PjnjDOS IS caEcul»ies tot pijsiLlw 50565 is bylc Ml6^ 
(J05£i^-(Si>K)rj * 2)) uf ihe third block fbLock -S2> qE ihc file. It 
iJnen ailocaies an Lndej block, Hoies itie addieas af ihe curncrii 
dau blodi In posniod (if [be indci block, aJlocatcs another data 
bIfKk. S1i(n«» ihc address cf that data block In posiii<>i^ 'i, ■>f [tK 
index block, and slofcs Ibe daw in. byws SOI 65 ihrauBh HH6fl of 
that data Moeli. The EOP is hctiw JU569- 

3 ITymj now sa ihe I^OH W S'fOOO aitd dose the file, ygu have 
a 16K sapling file ti^al ta:(es ij.p r.lin!e blodts uf spacr on Ihc 
volujne: m-n data blocks and an Index Mock, [shaded in Figure 
A W. Vdii can icad 163B4 hyes nf^it! rroitt tbc Tdc, but ill 
ibB bjlcs before S0565 afid .after 50568 air nuSla. 
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Ddhi HdcIci |I 
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X^^iJLi H 
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koi^^ di^ f fl r ^^^ 


fi 


*^ 




VXD 1 


J 






1 

1 
1 

1 




kiOn 


^ 






a 




^3 






4 










1 


1 WlJLi'i lr»-IUUlV 
1 wltfB" to <*1> 


31> 


J 


1 






ilea H 




An 'Bjnia'T*!^' <?i apcwsB TUS oroontaflDn ^H 


1 


Ttiis PioDOS 16 aUmalca voLurac space wAv ^™" "ho" Woclffi In s ■ 
file th»L actually cortliin idaia. FtiT U*e files, ific silualiop b H 
simitiJ-; iJ" non« dT ihc 256 djlla bLodK ISSigriiCd Si? an tnJeSL tloc* in ■ 

a tree TJe hawc been alSocatcd. ihc index bIwJt Itself is rw« ■ 
allnciLcd. 


1 


* jVfac. ■["he Elral dau blos^k "F a slindird Tile, be il a seedling, ■ 
HpLlng. or iree nic, is always allocated. Thtui (heie is ata-iiyi 1 ■ 
daca block la be read In when [be j!3e Is opened. H 


■' 


LocoHng a byte ^ a fHe ^ 


' 1 


Ttus is tiuw.' !Ci find a spccifLC byte aiihin a ^indard fBt H 


1 

II 

1 


The FUe Martt is i ihree-byic value iJiar IrKticitra an absoluic liriB ■ 
pasiUOrl wllhin a flic. If ihfl Ffe is a Tree Hie, ;hcfi the high-ntder ■ 
seven hits of l>i<; Mttk ElE[crmine ihe numbet (0 li> 1Z7J of th*^ ild^ ■ 
Wuck that poinw to the byie. Tliai. number Is ji'so' the location tJ the ■ 
low byle af ihe iivie* block addiCS? witlTdn tfw nuHSr indci blocfc H 
Iht location of Lhc WgK b/te of the Indeil Wodt adtliess is Ihai ■ 
number plus 2^, H 
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B^eE 


flyts 1 






ByiiD 






» 


7 6 S d 3 2 !■ 


7|ft 5|d'i Jl't 


Q 7 6 


S 


A 


3 


zlr 





Irtrfue. 


Ifidsx Block Nd. 


Data Block '-.un-iher 


Byle or BIOCV 



^pctejlo' 



Ties' File pnly 



Tre© arvi Sapling 



All 'n-eo 



FEgur* A-IO 

Fli» Mark teimal 



[r [he nie Is a tr« fDe or a sapUmg file, then the mem ejgtii bits of iJie 
Mack djctcitttinc the numbef (S^-25S} at Hie data block ppLnied ta by 
the indicated Jnde* block. TTiJi nvimber is also ihe locatiGm of the 
l(jw byie uf the data block iddrc^'^ nllhin the Index block. Tlic tugh 
byic of the iiidu block actdi^ss is (auni at that v^Jue plus 254 

foi ticCr sajdin^ &rvd seedling, fLlcs, Ehc value of lhc low nine bits of 
lhc Mtik is ihe kicaiion of [^ byte wiihlin ihe seiecied daia block. 



Header and entry fields 



The ftomqe type afhibute 

The value In ihe s^orage^cype /ield, the tilgh^jrdtr (qui biL5 of 
^ Htsi byic cif an cnuy. defines the type of hcadcf Of the entry is a 
header! or the type of Ctl£ described by flw enify, TsMe A-l lisu ihe 
Lunenily iteRriied Storage cype valLits. 
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St*rfl(iB iyp« 



Jo Indicates an inactive Hie cnny 

SI indicaies a seiedllna Tdc cnuy ■CEOF <= 356 h>ie5) 

J2 Indicates a rapUna fite entcy (25^ < EOF <- 1 26* bytes] 

JJ IndJcatcs a Lrt file ertlry fl2SK < EOF < ISM bylcs) 

$4 iRditatfc* a Piacjl opcraQng: system aira wi a pirtiuDiscd disk 

$D lr>c!iaic5 a subdJreanry fElc erjuy 

$E indK^lies a jutidiirccEary lieil(iCf 

H" indiLiiLcs a volume ciircrtnry fieader 

ProEJOS 16 luiomtlkally tihajiacs a scFjIIng Jlic In a sapliflft tlh: 
arwl a ^plung [Dc lo a uw Pile when ibe file's EOF girrori Into the 
ra^i^ Ibr a laiB^-'r lype. if a file's ELOF ahrJnts Jntn Ihc range (ot a 
amallcc lype, ProDOS 16 chiingifS i Mc He lo a «plin6 file "nd a 
Mpling fit 10 * seedling fikc- 




The ci»cirion and last-modincotlon Itokb 

Tlie dale and time of ilie pt^atian and liK n>o(Jincitiofi of eidi 
file tfid diroao/y 1% staml m vmt fout-ljytn vituca, a -shown in 
Yif^ni A- 11. 





Bylal 








B/ieO 






15 


lJ3p3|t2[ll|T0 


? [a 


;|.|5 


All 


?[' 





Y&ar 


Mcfithi 


pay 



7 


6 


b 


4 


3 


2 


1 





D 


mi 


a 


reSB'rvBd 


W 


R 



17ie access attrlbut* 

The access ittrlhulc fifdci, nr access, byte (Figmt A-123. fleLe«nlne3 

whether E^e lile un be md (turn, wrJcten lo, dclocij, oi jcnanmL 

II also conrains a hil Ihal ran br used Id indiiiK wihether t bldiup 
znpv ot the nie h3$ lieen made ^Incie the liie'9 last modiTicitinnL 



where 

D " deslfoj'-ejiable bJE 

EN » rT-njmi--i-n-j)il«- hil 

B - ha cltMp- needed bh 
W - wiiie-etiiblc bit 
R " read-enable Ht 

Act:sB! byPB tormat 

A bit wt Co 1 trtdicaiEa thai ihc DperatJon is etubled^ a h'a deued id 
indjcaici thai the upcHitiaEi is disatUcd. Tlic vcscEvcd bita aic 
always 0. The most lypicaJ selling for the access byie u iC3 
OlOOOrjll), 

PfOlXiS ]6seubjt 1 the bAckup bh, !□ 1 wfiEnirvcrllH file is 
fh3.r>gcd Cthal is, after a CREATE, RENAME, CLOSE aftcf 

viRiTEj or 3ET_FiLE_rHF0 opcfatlonJ. Tluis bit itrauid be fCMl 
to whewwf [he fi!e tl ■Etupliraled by a backup prapam. 

• Nate: Only PrnDQ^ 1S rnny rhififie biU 2-4, only fa^iiip 
progiruTii should dew hi 5 CLising CLEfls._BfiCKUp_BlI} . 
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■1 


1 

i 


TTw tile typfl^ Ditrlbuf* 


The filB_cypB fielti Ln idijc««yenir¥ IfientifLcatite type erf file ] 


C^-fdibed by ihil cA[iy. 'Hils Vveld shniiA bt lUed by appUuCLMi 


1 


I lO guantrUee niE tempi [j"bili;V from arte applirtlKm TO thi: ncxL 




TtK QincniJy deflnei hciailctiiiiiL vilues c^ ihu byfc ite lisied. in 




TaWe A-2. 




Tatle A-3 alia lisis [tve icharacUM mnemDnJE fite-lype todca [tni 




ahoitd appear H3n cataios iisLinjj*. t^Of iny file type wilhout » 




Specified mncmcmw! code, the caiaJos piDgram sIiowW substiiuie 




the hcsidecimal file type number 




+ J^We■ SOS file types am Lndudcd irt Tibfe A-2 because SOS Jfld 




PraDOS ha^t identi-cil Til* systems. 

1 




Tow- A-? 1 


PfoOOS II la 1vpm 




Fib hip« HAMVMTiic Cdd* DtKrloHon 
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$01 BAD Bad bltn± fili- 




al t PCD Fa^c^a] cwJe lile ■ 
iOit PT3t Pastal icitL file P 


S04 TKT ASCII LCKi lik (SOS »rKi PraDOS) 




M5 1 PD* Paaal dira flic 




Soi BIN Genera] binaiy '"'^ <S05 md PraDOS 8) 




SO? f FNT Fcrnl He 




SOe HJI GrapJtics screed file 




SW i BA3 Busiru-w HA51C ptegrtlM Tile 




JOAt DAi Dusijieis BASIC daw tBc 1 




SOB t WPP Word Proccssoi TiIc | 




$0C T SOS SOS systEiii) file 




$OD-$OC t CSOS re5crve<6 




iOF DIH Direaory file (SOS snd PipDOS) 




SlOt BPD HPStijia Glc 




Silt RFl BPS Itulei nJe 1 




112 1 ApplePi]? diM^nd flic 1 




m Ha t AppteFQe model We 
^B in t AppfcFile feport fnrraal file 






JlS t Scicen Library tile 




"""' °"™ 1 




1 

274 AppondlKBi , 
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^^^^^^I^^^^^^^^^^^^^^^^^^^^H^B 



^^H laH* k'2 feanliniMd) 




^^^H ProDOS ni» IVPM 




1, nik IVP* MnsiTWnIc Cckd* D*KrlDH*n 


^^H il9 ADB 


^pple Works Dala Sase Rk 


^^^H Si A KVJV 


ApfOeWcHks Wprd Prnc NH 


^^^H SiB ASP 


App)tWcnk9 Spr»(kl^e«[ file 


^^H S1C-SAF 


Cic*civcdJ 


^^H IBD SRC 


APWuouroe File 


^^H iDl OBJ 


AP^ oh'fcd. file 


^^H )B2 


APW L|!>r;,ry file 


^^M SB3 S16 


PrdDOa li applicaticr program fBe 


^^H RTL 


APW run-lime library ftic 


^^H 


PraDOS Ifi 5hcQ application Ftlc 


^^H SBli 


PfoDOS "ifi pennincnC inillaLiiallDn EEle 


^^H SB? 


PraDOS 16 temporary inlnialiHltlon. [il« 


^^^H sbb 


New desk laxsscty 


^^H SB? 


Clissii: desk acocMoiy 


^^H SBA 


Tool sec lilt 


^^B $BB-$BE 


(reserved ioi PfoDOS 16 load fEleaS 


■ SBr 


ProEKS li5 dftaimem TJe 


LgUH }CO-}£B 


Ci-escrvetO 


^^m PAS 


Pisail arei aet a p^iniUoaed disk 


^^H iFO CMC 


Prfl'DOS S CJ added catrntnind He 


11 JH-SFB 


PrsPOS a user derinnJ fJcs 1^ 


^■1 


CProDOS B jnscivcd]! 


^^H $FA INT 


[ntcgGi BASE program file 


^^H »P3 IVR 


EnKgCi UASIC viable Cilc 


^^H (PC BAS 


Applesoft program Ale 


^^M IFD VAR 


Applcscrfi vsjjablci File 


^^H SFE R£L 


■RelOL'aEable cmt file (EDASM) 


^^W SF? SYS 


PrnDOS S syaem pj-osiim fJt 


^1 +apply to SOS CAppte lU) 


only 


^^1 The QuxiiJary typ* ollrlbuto' 


^^^1 Some applj<!3lia[u. use an 


AnoMier Held irt a Rlc't diictioiy cnuy, 


^^H, ihc aiullJafy type lidd (,a 


uji_typa), to store addldcmal 


^^^H Jnf(M(TU.[Lon. nat speeil^ed by the fLlf^ type. ClCalog liallnss nay 


^^^H display llhe cartenh al Oils fkid urtdtfi [he heading "Subtype," 
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Foriraainplc. APWioun3eEite,'i<rlla type 5bO) indiKfc a 
l^tifffiis^& r^pe ctw-isnatiDn. iji the aujt_^type field. TTie siajtinB 
addirm fai PmDOS 8 eseoiirflble WnafV files <file cypa S04) 
miy be Id the iLU(_t>'pc fldd. The jrcord mbc for fjndom-accEas 
tettfiics C*il-B typo sai'Jmay beftpGdficd Je ihc BtLciliirTiype 

Pf0[X3S 16 and PrapEKDS 3 impOH; no MSUictiow CoUw^ ihan aLifi) 
on ihe COTUcrlLS & forrfiJl oF iJic auaitiuy type field. Indlvldu*! 
appUciElnm may use those Z byus ta sivK iny useful Lnfhmatian. 
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Appendix B 



Apple II Operating Systems 



I'Hls^ap^ndht eoplaJfLi- [he rc]a.iJDn5hlp6 between FraDOS 16 and 
thire Dthcr apcnling 5iralcrn5 ttvelopctl for [he Apple ]) family Cif 
ccMnpLiim CDOS, f fnDDS S, and Apple II Pascal), is 7^11 u iwo 
diji-eloped for ihe Apple 111 fSOS and ApfAe: 111 faecal). 

If you hj.vc written pnjgnm.i for tMic of Lhc clhcr sysScrns nr arc 
plsnnlog ut t^K prt>fto.f»B concunentfif e™ PrnDQ!^ lifi »nd 
arvDlhcr vfstan, [his appendix ixiay help ytnx see wtu.[ Chariges WiL 
be iuicssf.a.rY la inastei youi jn'ograxn fcain one system lo another. 
ir^'CU *Te CtiftueiTlng RlftS fPOdi i>^ Siystem lo annihcr, Ihls 
appendix: nuy help yau LiindcTsland why jKJine ^(jilvfiraLiIini (Illy tK 
rtrore sueosssful ihan mhers. 

The rirsi M;cti-cin jjivei a brier Jiisiory. The neia two scaiens gLw; 
general Compiriaons nf ihe odhcr opertlinif sySTeniS CO PtuDOS llS, 
in ittnns of file compaliliLlity and opcraCicrnal siimlajKy. 



History 



DOS stands for Disk fl^xroliitfi S^-iKm. Il is Apple's Tu^t Openilas 
system^ Hwrore IX3S. itie Hitnware Moplti^r pronrwa TOnLmUcd 
poBram ciccuiJan and inpuL/cutpuL 



m'i 



DOS was developed foi Uk Apple tl compurcr Ir provided Uic firai 
■i!apabJi[y For Mnragc mid rdricval nf viitous type! fif files on -disli 
{;the Disk 11!)^ the Sysiejri Monitof hsd sHowed i(ipui/<sjtpUit CoT 
brlnary ilaiaj In cassette tape only. 

The ]*iesi version of DOS is DOS 3.3. Ii us« i nS-sftctoi- disk Eomut, 
LiJic PniDOS 3 xnd Pn:jDOS 16. Eaclicx n^isians lisc a ii-salix 
formii [hiE ■canrwt be read by ProDOS S or ProlXfS ]6. 



SOS 

SOS h cfie openillng syKem developsd For the Apple ttJ compuier. 
1i£ n^jnc is an iizjonym for Sfiftharicats^ Ofttrtaifi^ System, 
Kflectinig its ini:reised eapabitnl&s uvur Dos On ihe otlscr hind. 
SOS [C[iijjn:s far moic mcmoi^' s-pai^: liun clUkc DCKi cr f mIXIS S 
CbelowX v/hldl wakes tt impnc^licoJ an 4:Dmpulcrs with las ihan 
J56K of RAM 



PtdDOS G ff« /^nfe^flMfl? £JB* Qpffraang i)3fe»«) ivi! drveSoped 
for Ihe newer mcrttora of the Apple r lamity o)f cnrnpijters. It 
fcqglres n \t;iH dAf. or RAM incmury, and i:aii nin on the App]c lie, 
Apple [I'L, axtd 64K Apple [I Plus. 

PcoDOB S brines sume of the advanced Jcitunis of SQS [q the Apple 
1[ fSjTiiEy, withuut icquLnng u oujcJi in^rm>r|' 3^ SOS tki^. 1l! 
canmtinds aju essenilal]y a subse[ of ihc S05 cammmds. 

The lacen version oi P/aDOS fl developed .speeincilly fof ihe Applt 
nc and Dc is PmDOS ft ( 1 1 I). ;\JS even marc rcrant vcraion. 
devetopsd fac the Apple OGS but compatLWe with the He ind Uc, e 

PraDOS 8(12). 

♦ WOW- Pnor In development of PjoOOS ifi, ProEXUS 8 wjj 
called sLmply ftnDOS 
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App^ndteei 




ProOOS 1* 

[•foDOS l(J is an extensive rcvLsiDn of ProDOS H. ■deve'ltiped 
apedficitly iOY ihe Appk flCS Gi; *'lll rwi mn aa other Apple H's). 
Tbe JiSfcfcis !□ the l6-bi[ inicmal icglners in ihe Appje nc$ 
■fiSCfti^ miampiccessof. 

PfoDOS \f> penmiis jc«S5 to the entires liS Mb addicssable memory 
\piis at iIk Apple lldii CPiuDOS B n, icauicied lo iddfesslng ^K) 
and li bAS more "SOS :iike' featufes ihits ProDOS fi has. Ii iIsd has 
HJimc nrw Fcaluics, net picscnl in SOS, [hit CIK ptOgJ^iTni 
pdevelnpment. 

There are twn veraintM of PioDOS Ifi. VeraLon l.O is a firat-rel&ase 
*yi(Em. ironsistirjg uF JL PrtifJOS ft COffl suCKHinded hy a 'Pr dDOS 
l^-likc' user [nlcrfacc. Vcreion 2 C L5 Ehe ■eompleie ijfflplememaiion 
oT the ProDOS l£ deiign. 



The Pa.'icsJ opeeitlng syf^uim for the Apple II is modified and 
eilenifed FrWn UCSD Paaiial, de^'eltjpGii *l (he Ufiivcrsliy of 
Califoinia at Sin Diego The litE^E version, 'written for Lhe Apfitc 
tk:/[lc and £4K Apple II Plus, is Faicdl 1 .3. 1[ a]»0 rum on an Apple 

Pasei] ftir ilw App4e III ks a cnndilicd. venicn of App^ 1 Pascal. El 
LMi SOS tef mo3* oF m opefiutvg. sysiem funciiotis. 



File compatlbjrity 

FidDOS 16, ProDOS Bi and SOS ail use a hiccariztilcLl I1i[^ system 
with ttie sime fdnnat and UFjanizitEon. Every' file on oik: f fsiem's 
dish an be tead by eithci dL ihe athcr sysicms. DOS and Pascal use 
sL^niflcandy diEligeeni ronnau. 

The other syslcras compare |q PkjDOS- IS as fpollaws: 

FroPOS &: Pi^DOS I& iiid PitrDOS S have Idci^CLCil Tile iyusm 
organizatinns — ihercfnrc. PrciE50S 16 can read al] PraDOS 8 files. 
However, (be Syswm liMdcr urtder PrtiDOS 16 ^-uill ncj[ iwrciiJf 
PioDOS ■&■ iJicoal3\Az bmaiy fika (type SMJ. Likewise, PiqEKM S 
can read but wi[l mn «ewj1e fite lypes SB3-iPP; thcM file types arc 
specific CO ProDOS 16. 
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SOS; ProOOS 16 ard SOfi have [lientical file syslcm orgsnlralinna 
— ihcrcrcire. I'roKJS ]ti dm tti^ Oml ncH cMlcyiie) all SOS ni«. 

pot DOS doc* iiot have a hicraitJtIOl] die Eyatcm. fcoPOS 15 
cannoi ijiwrfv read DOS Tilfis ttiul sw "Keadanj! DOS 3.3 iild 
Apple □ Pasol DIski,' in the foUfiwIns SEOicn). 

PoKQl; Apple n PiitiL dites nm haw a hiertrthical file syatem 
PfoDOS 16 onnM direaJy iciJ Apple ir Pwcal fib* Cbui sec 
'Reidiag DCfi 3.5 snd Appte 19 Pascal Diska.' belcw>. 

Appfe m Piscat Ltaes i>e SOS file Eysttm. 'tlMreforc ProDOS 16 tan 
rcid tJJul n™ cstMSJlcl all Apple ICI f'lical lifcs. 



R&adlng t>0% 3-3 and Apple II PascaE disks 

Bnlh DOS J.il and PraDOS fl IWK EleKlWc disks are kaoumcd using, 
tJic same Ifi-seclor lay'RUl- As a conscC[ue[1«. ihie ProEJOS IB 
REAl)_BLtX;K and WH1TE_BL0CK cs-ils- arc able EO ICCeSS DtJS 

J, 3 diTics too ThcfT t-albs kiVK*' rothitiE al>oui ibe pistaxiiiiiiort or 
EIlcs on &]&iei fVpe nl" disk. 

'tt'hen using HEBD^BLOCK and WRITE_BLOCK, you spcdtV a 51^ 
bylE block an ihe ^iit. When usina JCiin^ O^C DOS 5.5 ctMPteipirl 
(o eii;ad_hlc£K iini WRrTE;_BLor:Kf , y^ sp»clf>' the tiadc and 
Acaor nf i Z^fi-byie chunk nE data, is csplaifwd m the UD5 
/MJgrtWBim^'j .«ani«J. Td use flS1W5_b lcjck and 
WFJTa_Blix;K in access DOS 3.3 disk*, you miuL know wtisi 512- 
byte Wnck corresponds iO ite irack arwl sccior yuu want 

Tahfc B-1 shdwS how 1,0 liRCcrmine a block nun^r frean a given 
[lick an-d seOor. Fjri iniiliiply [he iracJi mirafacr by 8, then v-dd ihn 
sed-DT oftd. Lhal twnesp'jnds to the sccior nu mber The half iif iJie 
block In which tic scHoi icsidei ii determined by the hair-oT-bltKk 
line (1 is ihc fiiai hjlf. 2 ts vlw second). 



TubiB B-1 

Traelfs and Declors lo btockA <140< dl»k«) 



■ICKk numtwr - ID<-[n:ek nuinbvr) t factor olTuh 



HalfofblDcki 



3 



7 


s 


9 


A 


•^ 


i 


3 


2 


I 


2 


1 


Z 



c 


D 


E 


F 


1 


1 


D 


7 


£ 


1 


2 


2 



Biirer tn ihc IXjy /htijrraroi'Wfri Matual f" a dcscripiioft cJ" tiw File 
Dr^niciIiOjl or DOS M dLiks. 
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^•rating systenn simlkfftty 

This secilorv compares the fLinal<3nal slmJIaiLdcs amcins ihc 
□pctalinB systems. FujidJonll idmilaticy iM^-a^eeri IVO SfSlttiiS 
impUcs that the)^ perfatm doscLy idaled opciaCiLiEU, but it does niil 
mem dui thay haw tdeniical prcoedures or coinnunds. 



Input/Oulput 

PiuDOS 16 can pciTorm, [VO opca.'dons an files in disk drivei (blodi 
'diQvii^c;) nnly. Under PinDOS 16, Lheieface, the ourcnil 
application is r^^atuible iar knowing [he pfOtPcQl nccessarj' to 
conjmunicate wMi charactef devices (sudn. as the console. [Hinteis, 
md communJfsiJ'On pons). 

The DiheD systenu couipaie' to FriDOS 16 aa l(Aiuws: 

ProDOS a; Uke PreDOS 1^, PeoDOS 8 periwim UO an blocJt 

devices only. 

SOS; SOS commujiicates with ail devices, both charaoer dewjoes 
and Ijltsck devtees, bV' making s-ppropriale _flfe itcpess caJlf Cspeh as 
upcn, icid v,Tilc, d'C^cX UtH^r SOS, wrating to fine dcidcc b 
c^^ndally the saniQ as wriUE^g. to fnijLii^t. 

DoSs DOS iUdhk cnn^municatinn with ofic cypc of device 
fMily—die Disk II drive. DOS J.^ use* ai i^-seflof disk rofmat-, sitliec 
^■ci3i.uns of DOS use a 13-scetor formaL IJ-scdor Di!k II dista 
cannot be read direcUy by DOS 3.3. SOS, PfoDOS 8, oc PraOOS 
i6. 




Paaca\: Apple II snd Apple Kl Piscal provide icoes* to boih block 
dt^vJccs and character devices, ihiouBlh Plit I/O. Blodt I/O, and 
Oeptff i^calls to Lhe vt>]un>e» on the devices, 



FUlng colli 

S05. ProDOS fi, and PinDOS t* filifig caUs are ai\ dosely reJ»ted- 
Mosl of [he calls are shared by all ihrw systems; lyrthcniiatc, ihelf 
numbcra are EtfcnticaJ. in PtoIXjS ft and SOS ^PreiDOS IS c»lls hivn 
a camplecely dJliercnl nurafaering iysiem Trom eLthct PiuDOS 8 flr 
SOS J 
The tUhcr aySUiW COmpwe EP PralXB 16 U TollOWS: 

PtoKJS. a- The PidDOS a OH^LIKS ca!l catrESpondJ ID l3ie 
ProDOS 16 VOLUME oK. 'tt'hcn acvcn 1 device nitlKH VDLUKE 
reiurav liw; valuxuc name for timl tleuli^e When gfven i unil ruttter 
Cdtrivetli from ihe aim and nitlvc mmdjen), OW_LI!^ retunra ihc 
\M^lTjme name 

fbe Prooos 8 HEHAME dl] correspfflids LQ [he Pro[K)S 36 
cnftNGE_PAT ti ail except ttmi hekaME on chang« 'oaily ihc iSasI 
name in > fMihoamc. 

SOS: Tt^SOS aEI_FILE_TKFO otB nrtums iJic size oF [he (He 
itte vilue of P-OP). With PmjDOS l6 you rmi»[ HfST Open the flip and 
then use ihc Gcr^EOF calk 

The SOS VOLUME ciiL CMreapond* lo the PioDOS 36 UOLTJME 
ei]]- ftTien given a devjce namfi. VOliUHE returns ihc vdumc 

Tim: SOS calb SET_HABK and SET_EOF cm use a di!pJiCcraen[ 
(mm itK curreiu posildan In ihc Ilk. Pn?DOS T 6 lC<:epe» only 
abtsolure pwJCfans in the Hie Top ih(;«g L:a.LLa. 

DOS: t>OS Vt^if di^tJnjpiuih between J£^lf(?n/(£P^iA:c^eij:5 jncL 
raruiom -access [mi Cilcs. PioDOS li^ makes no such ilis[ln[iio[i. 
alihou^ (h^ VtanoS Iti Et^OD caU in NFWUNE mode FunoJons as 
t K'^cnEJaJ-arcrss n^dd. 

DOS uses APPEND and POSITION oommajitfa. rftighly aiCBitJf 
lo ProPOS lfi'9 s.ET_KRRK, lo sti [he eun^m posJiJon In the He 

and to aulumltkally CKKrid ihc siie afl\v fidt 

ITle CLOSI- £ramman,d Ln D05 tin be pvta In imftKdiiite (from 
the keybDird) or deferred (in i pra^itam) mndc No ProlXlS l6 
canunafid^ can be glvEii in inuneddaie mcde. 
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PtOCDl: Appfc n 7j5CJ[ dfetifigij [sties amantf i&H/Ua. ^sJOsS, 
and cniiejiiff, eich with diircrens header fijmiaU; ail PraDOS l6 
nies have idcriiicai tteadw (aimaa. The PimhI proctdurtt^ 

KEHBITE and RESfiT concRpondi lo PcoDOS ]6's CREATE ind 

DPEH calls. P^ca] hai nwre pcutwdLiies ftw reading from and 
wiri[iiiB tcj files and device ihin does PioDOS l6. 

Because Apple III Pa^^aL uacs tb» SOS (He sysieni, Ili GUng r-itii^ 
£0( respond directly [o SOS caJli. 



Memory managfrment 

UibdeiT ppdDOS 16. rcithi^ d^ optfiating syiEem npr The a|^cal9on 

propim pcjfonn mernury ma,naacmextti allocadon uf mcmorv is 
the reipotisibili^ of Ihe Memory ManiHef , "" Apple Uns rOM- 
bftscd tDol sei Wbsn Hi applkation nt^ds Space fur iu own use, It 
makes i difsct rcqjcsl In liw Memory ManiRcr. WTien it makca a 
PfoDOS 16 call i^ai retiuirei the allccaiion of memory sjuo?, 
ProDOS li maJiea the appwpriilc request to Ihc MennjfV Managct. 
The Apple lies Memory Maniger u simiLir t'O the SOS memory 
maiUEcr, cscept that il a mora snphiJLicaLed ard a boi ccuviii^red 
part (if die operaiing syMctn. 

IV' «htr sysianiti aimpare Id ProDOS l6 *j followi: 

ProOCM ft A PrnDOS 6 appliCAtion is itapQiaibk far its own 
memory manj^menL ll mus: Bnd Tree! memtsry, and then sllo«le 
][ by mar)<irtg il off Inlhe IpToDOS B gfobal pijje's rtremthry bit map. 
PioDOS B protcfts jllocitcd axeas tiy reFuiing lo wrilc lo any paffiS 
■hat am marted On the bil map. TKtjs it preven[s IhE liWr- Fwim 
dnHKiflng piolEclEd m^eiKiry sizis (as long as. all allDcatcd 
meriiury ia ptnperly marked off, and all daia is farouatit Inio 
mcmcry using ProDOS fl t-alls). 

SOir SOS has a fairly sophisticated Mera,Dry Manager that is pati uf 
the (iperalJnB sy-Hcm liselif. An appiication [eqticsla mcmojy frcm 
SOS. either by location or by the amfiunL needed. ]F the requcM Mn 
be satisfed, SOS Branis il That portion oF memwy is then the sole 
WSporuihiliiy of [he requestor until it is released. 

D03l 0O5 perfoims vv memory managenMni. Eadi applieaiJon 
under UOS is cornpleiely responsJble foi ili own memniy 
allrKaLon jnd use. 
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FfBBol: ipple !1 PaEta] uses a. simple memory ncanaBemctiE system 
Lhat conirala ihc Hciatlirtg snd lirUoadlna of code and daia .MJgiDcnts 
and tridfi ttw si?r trf ihc 5tadt s.rid Iwap. 

Apple ni Pascal uses SOS fw memnry manaBEmcnL 



Inlwniplf 

PidDOS l6 does not luve any budt-ln anlcnupC-^rtefUlitVg dm'icc 
drivera. Intemipt handling routiiifes are iherefore InsiaJILcd inic 

PtaDOS 16 scpilrtiely, u«.lnj!the ALLOC^IKTERRlfPT C»ll. TIbtn 
an Interrupt odoits, ProDOS ifi poJIs [ht hmdling routina m 
sucECssitm unuL one cJ them claims Uic JntcnupL 

The- othef syswasM HTwnpaj^ tn PiiiDOS 16 eis follows: 

PmEXH B: ?ro[X:i^ f\ h^ndks [nicmjpu identically k> PttBQS ]£, 
cK^pt Ihal il aUsiws (cwtr [ilSUlJecB handlcis C^ ^™, 3-6J- 

S08; In SOS, lily deviffi tapflWe cf acncratirg an inlcrnipl mu5t 
hai^ a device diive-j tapiblc of handling iJie ifitem>p(, Uie devlcr 
diiver ;lilJ lis inwEivpi. handlcir aic Lnscpmbbc and lit coAi'i^rf^d 
to be pan of SOS. Tn addaUun, SOS Sffiigns a di^tuiLiL lulcnupl 
pfiiorJi:V ta ■cuth device in the syslcm. 

OOJ; DOS Joes rwi support inicmipts. 

PbkoI: Applf [I Pasca] vcninns 1.2 ard 13 suppcn imemipta: 

earlier vcj^inns o£ Apple Ei Pti^^l tSrJ twi- 

AppEe It] Pucit uses the SOS Intenupt SiysItiiL 
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The ProDOS 16 Exerciser 



nie ftXX^S 16 Exermer [s a pfD^sin [han \tts you practfce mflktri^ 
OperaUns sysiem alls withoui Wriling an applicjliftn. All PraEXJS 
16 runctons ciccuie just la ihcy w-ould *fhen called rrom a pmjgEam^ 
ihcrcFntc )■«! ■can leM haw the calls wnrk and, [f rKCSJaiy. ctrrj-Ect 
iTkv pTOijcamniins crrora bcbic coding your luutincs. 



Starting th* Exerciser 

Rrst, make a copy of the ExcfCiSei dsk and put the original away in i 
Mfe pSaoe. CansuU y«jr owner's manuil if you nc^tt iiutnjcdwiK on 
how to oipy I duk_ 

The EKcrciser may be the atjnnjp pnogram nn ihe ijulcriic pfovided 
wjih lJli5 manual If su, || stiDuld cxeajte iulDnulically when ymi 
turn on IJi? michine aaid injen [tic [liskcllfl. Otherwise, stleiri |i 
liom Ihc desktop HDf pTUgiam liuncher Thai ramcs Up "ben you itari 
up ihc sysiem. THk program's. i!iEcnarr>e [s exesciser. 

The first dispEay is ihc menu SCnxn. It jhowg lU ProDCPS J 6 aJIs by 
numbsi mA mamt, as well a:^ a few other ccmmutds you may enter, 

The menu screen always returns between etecuiior irf caHa of 
CCimmand! 



z«> 



WarnEng 



Medcing system calls 

You matr s^icm calLs Trom ihe «3cerciser by erUerinB ih^ 1=1^ 
TiunitK}^' TiiE rujnix! yohi enter is displayed il LtM bi^T[«iYi nf tbr^ 
menu ^screen. You may clea' tte nuEnbct at any time by preaslng 
zero twice in sucizessian. 

After cnlerng Oie nunttiet, pfESS ilie RfitUEfi tay. The ponuncLCi 

block f™- the ciU yau selected is djsplsycul Enitr il viUie for select 
the d^fiiili prtrtHded by pKSS-lnf; the fUstum key) fw each 
f«j*inetfir; each time you ptcss Rchim, Lhc cufSO-r mpi>v*S iOWFlwillJ 
One position It; the parameKf hlocli. The air?w docs not simp at 
any pwnvU}! Ihal 4 a tcsutt 4>u/)i (that hts tw input Vltue(). 

* NO10: If. UJAi/tf jTJW aw CTHi'rtrafi parameters, ytm wish lo 
COf^Ct a vaJue, pfess the ER^a.pc key — it posiiiotui the cu-r^cir 
back ai the mp oi the paracneur block. Al any oflioi liira. 
hnwcvcr, the Escape- key iciums yaa 10 the main menu. 

Pathnames anri nlhcr Ictl strings an: passed. [0 anJ riuni t'loCOS lO 
i-R btjEiers leferet^oed by pcJniers in the pifamcier blccfcs. 
Tbcicfoic, la cntci or acad a padinJirnc yuu ixkuS[ prfivkte i b«ii!ei 
[qc I'mDCB IS tc read from or uriie tti In mo?! cases, the Eicjciwi 
icts up a default buffer, pointed lu by a. dcfaull puintct t'a.ra.[n«tC:r 
C^e?, iQi ^3iiip[«, ihe CE'^ATE calJ]. The contents at (he ItKAtlun 
refcfcnt^ by ihat poitucf luc tisplaj'ed on ihe sctecn. b^lcvr the 
piramcrer blodc Kw ^□(wcnlenec. yeu can Jiredly edJi: the 
disptayrd lUring iirt ihc sirrccn; you nccdnl arcCJS iht mCfflO^y 
bociiJon liselF. 

AEt(!r you. hive rntErrd all Ihf irquircd parsmeters, prC&i the fitlulTi 
key once vcksk to execuie the all. IFfivedythltig has gone dghi, ihc 
pirantctcr li^t ni:>w tnntaJEU rc^utts returned by PioDOS 1£, and ttie 
cnessa^ 'SDO uH ^t^cessrul' ippeais at the tjOKcmn of iJie sci^^n 
if a ProDOS 16 error occucjn. the prnpKf eccai numbcc and meesa^c 
ac^ dl^pliye^ inslvad In addition, if an tfimr occuin 1 .small 'l' 
shuutd appeic at ih? Ei:n^'cr rig]]! 'Cottiet uf the; screen, 11^ indtoie 
thai the inicrciprcici:££ar's cany btt has b^n set. 



The Exerciser dcies nor prcrta^n yau fratn sqIIolis mUrc^kei Wllh 
a Mr.l7r_PC.Ci; PC ea|l yau can ea*y over\uri[B o ciiHcal blcci O^ 
orw o' youi d4ks, cFwhoymg vaiusbl* na daio or 9v«n ttta 
(fisk's directory. Wllh □ caretess ^Liuni^T coG. yCAi <iiin dsfiEroy 
Oil) hfwJTcrfton' on your dl»k, S* cavfU tww ^x>tJ u»5' tihii 
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Other commoni^ 

Irt addllion to prsciicic^g ayatcm alls, you may tssye COmni&iMLs 
thai alltMC- yuu to ]i!t ihe coiVienU of a diiectory, mcdify itiy pan of 
the Apple QGS RAM mcmoiy. enter die Monitor progrtm, or quit 
the Exerciser. 



Utt DIlwctolY (U 

P«si L and you are prrjmptcd for th« pnJiname t>rilie vohunt or 
Subdircctrwy '^liosc rantcnls yoLt Wish 10 LLit Por each Rt in tt^ 
diseCEOEy, the ILstlnji jhuws (He name, file type (sc* tible VB, 
luinbci of blodis usitd. date and il me df list modifii^tiun, dale aaid 
time of cnsiiion, EOF dosn.^] aizc Jr bytci). ajwl suhtype (vahie uf 
the luKiliaiy fypt i3eltD. Ptcas !he l^capc key to return to the main 



Modify Memory {M> 

You use Lite Modi^ Meraujy ccimma nd 10 place dan m memoiy for 
ProDOS 16 to read, oi 10 Jnsjiect the orjntenDs of a buffci Lhas 
ProtXK]& tiuBjrJiien !□. 

PrcM M and ynu are prampljjd for a pDinsct in (he pirt of mGinorv 
ytni wish if> aiCCcss. Enler tFic proper address and press the tetunl 
key. A 256-byte Cone pigc> portion of mettBry J5 di^pJuycJ. as IS 
tCKMS uf 16 hyles «di, bcijlunlng on a pije boundary. Each rnw Is 
preceded by iJic addnag of ihr firel byte m ihat row; to ihe right cf 
each iCTw ate the ASOI rcpreseniaiiuns of the vajufes of ihc bytes In 

ihc IQW, 

Use the amrw keys !□. move ihe cutsar aro^jnd on ihe screei- To 
change the value of a byte, type ihe new vaJuc rijjfjr over the dd 
one. V™ can, cnler d»ta in [lexadccimiif fr^nnal only, tJie resulls of 
your entry are di.spEayed on ihs screen in IkhH httiadecimal and 
ASCr. For ftFtricncc, Table C-I lisLs ASCII characters ind thcii 
decimal, hcKidedmaJ. and hiniiy crjuivalents. 

Ycju may undb up to (he last 16 chajieea ynu made by lyprng U 
suctessivcly. To display die ptceedlng of sucorcdin^ page ul 
memoiy, press- < m >. 
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ASCII 'Character lAl 












Chai 0«c H*X 


linnry 


Char 


D*C 


H« 


unov 


soh 1 1 
aK 2 2 
elx 3 ^ 


OOWXKKM 
OOOOOODl 
00OW01& 

OCODOOll 




40 
41 

42 

A'' 


2A 

2B 

2C 


OO-IOIWD 
OOIOIMI 
00101010 
0010101 1 
OOIOIJDO 


enq F 5 
ack € 6 
be! 7 T 

ht 9 9 


woooiui 

00000110 

wowni 
ocooimi 





45 

47 
49 


2D 
2E 


ODIOIIO] 
00101111} 
OOlOll" 
OOIIOOOO 


IF 10 A 
n 11 ft 
IT 1£ C 

cr 13 □ 
SQ l-l K 


000014] 11 
00001 JM 
00001 ]()] 
000011 ID 


1 

2 

3 
4 
5 


A9 
50 
31 
52 
53 


31 
32 
33 
V. 
35 


■00110001 

cioiioaiO 
Miioon 

OOllClOO 

oonoici 


ai 15 F 
die l6 IQ 
del 17 11 

^f? 18 IZ 

dc5 19 13 


{xnoiin 
oooioooo 
woiwoi 

(MOlOOlO 

000 icon 


6 

7 

9 
9 


5F 

57 
58 


37 
iS8 

3A 


oonoiio 

WHO] 11 
OOIUOOD 

Minwi 

0D'111[>|l> 


l1i:4 20 !>; 
naJt 21 15 

«yn 22 16 
cth ij 17 
ciD 2A ]8 


OMIOTOO 
OOOlOl&l 
OOOlOllO 
CK101C111 
00O19DOD 


If 

1 


58 

«2 
<5 


3B 
3C 
5D 

3E 
3F 


OOlllOlt 
OOllllOO 
ODllllOl 
OOlllllQ 

oounii 


cm 25 19 
sub Z£ lA 

CK 27 IB 

fs 28 IC 
6= » ID 


omiiooi 
ooaiioio 
oooiion 

OOOlllDD 
CXMIJIQI 


a 
^ 

B 

c 

D 


64 
65 

67 

68 


40 
42 
44 


01000000 
OlOOOOOl 
OIDOOOIQ 
01000011 
DlpOOlOO 


IS 50 IE 

US 31 U* 

sp 32 20 

1 JJ 21 

M ZZ 


00011110 

OMllJtl 

miODOOO 
wtwoci 
OOIO0OH3 


R 
F 

c 

ll 


69 

70 
71 
72 
73 


45 
■17 

4e 

49 


1000101 

oioocmo 

OlOOOlll 

01O31OOO 
oioaiooi 


* 35 23 
S 3e 24 

% i7 25 
it 3ft 36 

59 i-y 


ooiooon 

0O10O1OO 
WJCOiOl 
MlOOllC 
MlOOlll 


J 

K 

L 
M 

N 


74 

75 
76 
77 

7& 


4A 
IB 
4C 

4E 


0100-10 10 
OlOOlCll 
01001100 
OIOO] 101 
OlOOlllO 
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ASCII criarncter 


Kir 












cnitr 


Dk 


h'lji 


llrvQiV 


Chor 


D«f 


Hm 


Ihnv 


o 


79 


4F 


OIOOllll 


h 


]0i 


6ft 


01101000 




? 


SO 


50 


01010000 


i 


]05 


69 


onoiool 




Q 


Si 


51 


dioioooi 


j 


liW 


6a 


01101010 




H 


S3 


52 


OlOlMlO 


1c 


107 


6ia 


01101011 




S 


?J 


F3 


OiOiOail 


] 


lOS 


6C 


01 101 100 




r 


a^ 


54 


OIOIOIOO 


m 


ID? 


6D 


■OllOllOl 




LI 


to 


55 


OIOIOIOI 


n 


110 


6e 


flllOlllO 




V 


86 


56 


OlOlflllfl 


□ 


111 


6F 


OllCUll 




w 


87 


57 


01010111 


P 


112 


70 


OIIIDOOO 




X 


8S 


58 


oionooQ 


q 


113 


71 


omotxji 




y 


S? 


W 


OlOllOOl" 


r 


114 


73 


OllIDOlO 




z 


M 


5A 


DIDIIOIO 


s 


115 


73 


01 noon 




1 


91 


5B 


01011G1] 


L 


116 


74 


OUIOIM 




\ 


32 


SC 


OlOlll'QO 


u 


117 


75 


01110101 




1 


9i 


5D 


01011101 


V 


IIB 


76 


01 1 101 10 




■\ 


tM 


5E 


0101 ma 


W 


119 


77 


01110111 




_ 


?5 


5r 


OiOniii 


X 


120 


7a 


OIIIIDOO 






96 


iSO 


OlIOOOOO 


y 


121 


79 


oinioDi 




i 


97 


61 


QllOOMl 


7 


iz; 


7A 


OmiDlD 




b 


98 


62 


OlLOOOlO 


[ 


123 


7B 


01111011 




c 


99 


iS3 


oiiooon 


1 


124 


7C 


[IllIllOO 




d 


100 


64 


OllOOlOD 


1 


125 


7D 


onnioi 




c 


101 


65 


01 100301 


-• 


136 


7fi 


OIlllllO 




[■ 


102 


66 


oiioono 


del 


127 


7F 


oiiiiiii 




» 


103 


67 
V 


01113011] 










iTamlnB Moeftf rjfernory do«l nol pie^ertt ywj Itom Changing valii« in 










pariB of fr«may rhot a™ 'CUvodv In lbb. Vou cart laanc&ivnbt^ 










altef WW ExHTcissr ift«ir or other cririta -coda, cxiualna a wMsm 










crash. Be Gareful what 


vou modiiyi 












ExtttoMonttoiOO 

The Monlioj \i a. (limware peogtim H>cc .4^bfit tt(S FifMWars 










/fefftvnce) ihii alkia^ y 


□u lo tnspea ind 


mcdify Ots 'C^ifHienUi oT 










tntjnory, sjsemble and ■cUaasieniljJe code 


in a IJALiied nunner, u^ 










e^ecuie code Ln memary. Yoi 


fujj' encei 


[he Woalioj frtan [he 










PraDOS iS 


Erciriscr 








. 
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To all \hs Monlnjf, piess M, when ihe Mcniroe prompt CJ 
Ippeiin-, you miy iS-SLte any Mcmiloc comnliind- To leave [he 
MoiiiEOf afld- fetum ta ihe Eiierciser, yau musL rcbooi the compuio 
(ptcss CoiUjoi-JS-tieset) »nd, [f ncccssai^, le-excculc the fijierSiStr 
flTOTi Jje desktop or progrj-m launcher. 



QutttQ) 

To quilthe PrrjIX'S Ifieicirdsci-, simply press Q- Of cau«e. you 
may also quli tjy selecting &>e PtoDOS 16 QUIT cjH diT}, filling 
oui ihc p^ra.i^i^cef Meek, and cxcoiEing clw caD, 



394 



.Append bcoi 




Appendix D 



System Loader Technical Data 



This_ apprnduc i»emb[es Jp&nse ipedfie Icdmi-caJ dcUlls on the 
System Loader. For iiidec tnfLiii[ia.iia[i, .^ec the refereFK^d 
puUiuFJqn;. 



ObJ«cf module formcrt 

'i^E SySIrm Lojdri can Itud nnlji' imjt; ^nd tiiiS, SSgsVXCllS [hit 
cortTDrm la Apple l[CM object modulr (ilnaaL Cfb'p:! niDdulc 
rormaT la des^ibcdl in detail in Affie IISS Pnjgrspumeri 



Rie rypes 

PUc typts Tor 1*1(1 fiEes ind olhrr OMF-iElaled Tileif are listed Islow, 
For 1 compfcte lisi of PfoDOS file tvpefl. set Table A-3 in 



a« 



i<i>t- 



ApD*ncllKBa 



FltoiyEW 


aaKitfAhK 


$ao 


StjurtC file i.au3C_^pe defines IsjujuaBcJ 


JBl 


Ohjcrt lile 


SB2 


library fUc 


iai 


AfqjlJtalkirt file 


$B4 


HuiL-tiRbc libfary lUc 


til5 


Stvell appLitiiiort file 


SE6-SaE 


j!tesffFi«d/™'s>sWMH«- OuTieHiJji dipyirtRJ IMMf 




fJKtude- 


SB6 


P£fffliiibcm iniiJ(J3liaU<jn file 


JB7 


Tcmpcrary inllJalizalEuii file 


si^e 


^'ew itesH iccosory 


iB9 


C^^ic desk iCOtSKrf 



Segment kind* 

Where-W fites m: da^irKd hy tjpc, ieprienxs are classincd by 
kludl. Eidi scgmeru has a kind deslgnatron. tn ihe K END field oF in 
beadei- The Gvc tii.sh-rtfda bLOi in [he KIHD field ilesCiHIje specific 
attributes of ttie w&mnjH; ihe v^tac in ihe low-order five-bh ELc]d 
de»ctjbe& ihe risti^II iyp« of acsmcrm Piffcrcnt comlJln^aiu of 
arHibuics and lype vahics yicLd (lifTereni icsulu Tor the scB^enr 
kind 
TIb kind Held is CWO tiytcJ long, h'igUfe D-l eiwiws lis fgmiaL 



Byte 1 



SvtBD 



15 



SD 



14 



1^ 



12 



SM 



A0 



m 9 



STTTTIS 1 



(;rBKFBrv^d'} 



7vp.a 



S^QmBhl kind fonnat 



whcic the (iHrtAuMtiuCll-lSmewithcfbllowlnt 



SD fbH 155 " stitit'dynimic 

Pr Cbii H3 •^ private 

PI (Jill 155 ■ pnsJiiD"i-ifi*P^"f'^''t 

SM Ihii 123 ■ fn"y b* "" apftdal irmmnwy 



(0 - miict 
1 " dyuainJO 

(0 ■ ra, 1 - yrs] 

ffl - no; 1 ' !«) 

(0 = yH; 1 - no) 



ABiibJtn) - ?.lH)OlMte-bink C)-raj;l-rH> 

■ (birlO) - Reload ffl-no, l-ys) 

and tiv. lypf field {blls 045 describes one □[ ihc (blli;<wlm{ 
dl.S.S'i fi'^liclns cif ihic segment; 

300 code £«Braen[ 

10] rlaFa M:£nicni 

J02 Jump Tabic scpncnl 

S04 Pathname uflmcnc 

Jos lihflirV didtJOTiary acemcnl 

1)0 inillahuljnn segment 

ti^ dircct^page/suck segnncni 

Stgincrl aUribnilcs an be combined wilJl pidtcular lypcs ta yicLd 
dLiliin^flt fesulum viJucs fur Kihd. Fnir example, a dynamic 
initializjlion Scjjmcn: has KTNB - SSUIO. 

* I'Vofe A RelOid segment is always Dna^^d from the fife when a 

piTDgtim starts up, even if ihe prDgtam Is restaned Tfftfti 
memory. l\ w uwd to inJtialiia data fnr progrtBiu that would not 
Qthruwlw bo resiartabie. 



Record codes 

Load flcgmerai, like all OMF segmcntB, are mad& jp n( records 
F-ach type at record has a Cflde otJiflber a nd a name For a complete 
lis! of tccard type*, see Af^ie iJCS Prcf[TammEr'S IKartjAo/) 
^/erenze Tlie oiiIk record types reoogniKed bj- ihe 5ysLem Loadpr 
are these: 



VrconJ 
CDdi 


hi mm 


QtKia'itwi 


Sez 


HELOC 


inlrascgmenl n;ltKatijjri recotd Gti 

jE]acaiJ<jn tLlctioniryS 


5E3 


INTERS E-G 


jntcracgmcnt mlptatJon record On 
iclacatlon dlcii'OTirj') 


5P1 


□s 


zcrtr-fi]! ii:i:ard. 


SP2 


LC0N9T 


[onfl-cotiscanl ircord (\hr acta*] code 



and data, for each }egin«n[> 

rcccird (in reloatEOEV dicttcmary) 
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WT 



tacHd 
Coett 



Dvicrlpllvn 



JP6 



cINTEEtS.EG cUOIpreSiBcd inLcrJiJgmcrl rel<>aEiQn 
■ccofd fin irelncilian djcllonaiyj 

SUPER supar-camprEEBeJ. faloc^oit [ecorrf 

(ihc cquitaleni at many cP^ldC at 
c!tJTEa3EG nccnnls) 



EHE ihe t^nd nE ihe aegntent 

If [!ie lender cncDunwcs any aihci- lyp« cf recorf in b ln»d KgrncW, 
II ttuittm eiroi i 1 lOA. 



Lood-fLle numbeiB 

Load rites pccstcsscd by ihe Apptc ncs ^rogtammEf's Workdiop 

linlia ai any urtu ame irc numbeeed conscniiivcly Tfom 1. Load file 
1 la called itic Jnitlil loatl flk'- A]] other files SJ« cnniidcrtd Ifl he 
nin-limr libiMlCia 

A ItHd-me nLimtJcr eT ifl a Jump TaHc segmenl w a Paihrflmc 

legmcrU indicalea the cnil of The M-pTiani- 



l.oad-s«gment numbens 

In cich laid file creaicd l>y the Lkilier, wgniciiLii i(e numbered 
tunaet^sJi^ly by ihc-ir posttion in ihc load file, fltuting a \. The 
loader dcccrmloes a !<o£n*cnl's number by coumlng l^f ptJsLliun 
from (Iiis bcBinninB ^if thp i™rl Sic Aa a Check, tJie Lt^itfer ^Lso Jcoti 
at the segment niimlKr in ibe s^gnisnt'' hcidtr. 

"The flf?! SBiit scginem In a SoaJ file, whldi nesd nnt be sfigmcnt 
number ], is called the maSn segintrtc— n ls lo-adei! fi*at (Mcept fw 
iiiy preocdUiR intualiMiitm sejyncjiiij itiJ orvoi Iciv-cK ntemorf 
wtiUc ihc prt>3fam Ls MECTlting. BBt^aii'ic a tun-Ucrte llhfary need 
hive fio Stalie scBmejiW ilt a]], il ly pLcilly ha* no main segment. 
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Segment h»aclari 

Thft Rrai part nf every ob|eci raodLilc fmnial jg^meni Is a feSTWrM 
header, ii contairvi 17 feids iJwt give ihe oimc, sLa;, jmd odier 
IffljWffant infarrtatJon aiXrul ihc SE^fmsX 



RosJrlcHoru on uflmcftl hKidtf vahm 

Jieciusc OMF aupporli capahititles iflSE itC mure gcnprjl than the 
Sysjem loader's rieeds, [he System Loader percnjis load files la iw.'e 
Colly a stitiwi of all pdssibLc OMF charaacrsUcs. The Inadfif does 
Uiis bj' lesuitiJnB the values orsere-jal Bcgmeni besdtr fields: 

iraK_aEX; mtJiLbcO 

NUMLEW : must be 1 

BAHEsrzE; miiELbe IcK ihaji fw et^al to lioooQ 

ftliIGM : mua be kss lhif\ <:«■ equal to J 10 000 

ir iIk Syaera. Loader finds any oUtei valuer in any of the above 
rie3d.i. It KUnns enror $11 OS fSegmcni Is Foreign"), the 
feSD-ifUons nn BlMKSlJfi and JLLI[^ are enforacd by Ihe APW 

Linker also, 



F^e-Dllgined andbank-aEgn«d $egrn4firi 

In OMF, tlie va luci of BiMKS ) <1E md ALIEN may be any mialt^le 
of 2. Biui Tieeijsc the Memory Manager and System Loader suppon 
tmJv Lwci types of aSiSnmcnl Cpa£c- and banJi-aUgnmcnt) and aiK 
bark size (fi-IKJ. ihe Systnin U^ader jscs bath BANKS r EG and ALIGM 
values 10 nmtml 5egn»eiri[ aligrancnt, as Enlliws. 

1. If BRNKSTZE Is OE S ] [HlOO, I LI value has na effta m Scgntcnl 
alignmeni. 

i. If BANKS IZEb any cdier value, the greaicr oF BANKSIEE and 
ACilCH Js called [he al^mBot /x-ior. AJjgnmciru in memory is 
cnntrolled by ihc alg^ii>enL fecicr in thia way; 

a. Ji" the j][giiiTicnt iadmr if 0, itK segmcnl is not aJJgncd [□ any 

(ItSmury bovJTuijfy. 

b. If die aUgnment j^hm b peswt than a and less thin oi equal 
lo J]iJO, the se^meni is p a hc- aligned 

c U" die alignmenl Facro* is greater than *lOO, the segment la 
banb-aligjifd. 
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2W 



, 


■ 


1 


• Ncte. The Memory Maniger ItsplE decs not directly support 
bank-jlJsn'™^fii- 'tli* System Loadei forces bink iJlgpsmcn! 
wheic needed by requesting blO;S» in successive banks uOlJI il 
Ciinds OW ihii sUrts (th I bulk boiirHUry. 




Entry point and global vaifoblstt 




Tliere L>; only one entiy p<"rt[ needed frw all ^yaum loader oJla 
Actually, all too] cilJs). I( Is En ihc ^ple [ICrS [onL diipaichcr, at Ehc 
baHDin of bank JE 1 (address SKI OOOOJ Wthougti die System 
ioinier mainiaLQiS merrwjr*' spioc and a uble of loMtf funnions tn P 
oihcr pirti of memory, lixiaiJwis in Uiosc areas are nnt supported 
Plesw make iU 5>3Km LoBttei ta-Lls with i. JSL Id *E1 0000, n 
cKpLai ned Jfl Chapter IT (Or ■'■iih nacia ciLLs -or ytlief hLeJici- level 
inierficc, if ippraptiarc Far yuuc Ungu age). 




TTie foil-owing variabLcs. are Of globiL significance. They aie dclined 
It ihf syflcm Icvd, so iny ip^jlication liiaL needs v> tnow their 
valuca may access them. Howcvei, on]y USERID ia. imponani la 
moftt applicaUans. and II sTujuld be accessed only ihroujjji prapet 
alls lu ill* Sysiflm LuidcF. Tlie oilier vanabfcs aic needed by 
comroUinB. programs tmly, and dimld not be ascA by 
jppHcaiions. 


1 


BEtiTBl. AtMotiitE address of the MHjmnty Seamcrc TaW^ 
JMPTBTi AtMOluce iddicss of Ltic Jump Table Dircctoiy 
PATHTBL. Absfiluie address of the Pathname TaMc 
t]3ERlD (]scF ID dF the oiireigt applicaLion 




User ID format 




■Pie Ifwr UJ Mli^ger is dJ.icussed Ln Chipper 5, and tully exjilained 
in Apple J/CS Toolbox Reji^rmt^. Only the forraal oF the User ID 
number, rccdenl 1.1 a parameter for SKStem Loader calk, it jtwjwn 

tKre- H 
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Byl 


e1 








By1e[: 






ish-ilializ 


ii|io|p]s 


7 


^ 


5 


4i3 


2 


MD 


lyue ID 


Ali);ID 


Main ID 



TTiejc [s a Z-bylc Usci ID assodalcdi with every illOOHed rneiWSi7 
bloek. U b divided intQ dirse Hclds: KainXD, A-ujlID, and 
TypelD'. the Main ID TieliJ cun tains the unique ntymbet ui^t^tedi'Q 
the awn^f a^ die bkKk by dtc Usa ID Manager; cveiy allocated 
Mock \ii3 ^ iiurtEemi vaJue In lis MalnlD fteld. The Ait^It^ Tteld holds 
a user -ass [fnabJc Jdcntifieaiion; it is iBnored by Che System Loader, 
ftteDOS i^. and the user iD M&nigei. the Typo ic field gives die 
genera] dass «?E jcAwaiC to whicti fhc btodi belongs.. 



Bit. 

Jser ID (ormoT 

KalnID can hive any vjiue from SOl to }FP (0 is rserved) 
fcuKiD an have any value frotn SOO lo iOF' 

Typein valUCi iirc defined IS ruiio«3; 

JOT 
S02 
103 
!D^ 
so* 
141^ 
107 

los 

1*9 



Memory ManagFi 
ipplicitdorl 
Luntrulling program 
PrarXW 9 j)id PraOOS 16 
ttwL set"* 
dcslc accessory 
ninH-me library 
EyFtem Loader 
(IrEnwife/systcm function 
TtJOl ]JH3lOr 
$OA-F iLunderined> 

if type ID ■ }04„ thcK values oE AuxID aic icKrved: 

SJ>1 MLv*tUne0U5 ToolWt HI? 
S'DZ iicnp Manager like 
$0A tLxil setup file 



Appeodbt 0: SyiteiTii Laadar TM^hnlCQl Dale 
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Appendix E 



Error Codes 



This appendix lists and dejcfibcs at! emir codes rctumetl W 
PmtXW 16 Mid [he 5f sicm Loader Each error cndc is fnllofl^ W 
the crruf's sugscalcd nirte nr acnrcn message, and 3 br^EHf 
dtSCTlptiDn of \L3 stgnifitanCt 

Whca an cmlf 0CCUI5 during 3 etil ProDOS l6 or ihc SySKm 

luidet p.laia^ the error aumbcr In llw accumulaior C^-rcgi5[Er>, 

iels ihc stilus (egistcr cany bii. and jwuim conu-i?! £□ d%e aiLLng 

rouLine. 

[f. aflEi a caL, [he arry bit Is cicaf and ihc atCUfnulilor OTnuiiM D, 

ihll signifies a auOXSSEul rompleiiOfl (fio error]. 



PfoDOS 16 errors 



Kpnratal ArrofS 

A lujfiTiu] erfor MEnilie* ihai a requMted ■caU could not be 



3CC 
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1 






NuinCw 


H«fSQB« i^hJ Da*Ci<pFl4<i 




SenemffffTDH; 


n 


SOD 


Cnn eriL-jr) 


J 


Soi 


[QTnllil call nambcri A nnncjcLttcnE cfimntand has 
been iMucd. 


■ 


Sot 


PfoTKJS Sa busy. The taJ] clnmrf be made bec^uM 

PrtrlXlS 16 is busy wilh anodicr ciU. 




;iD 


Device aat foundi: There » nn (l^vice nn Ul>e wfth. t^s 
gnven name teET.^DEV_fiUK ca!D. 




Sll 


Inrallri device rcqucfili tlie (;cven. device nariK f>t 
rerwetKe numlwc is noi in Pn^DOS 1.6's lisi of aciivE 
devicEs CvoLUHE, hejuj block attd WHITE BI^CK 
cialls) 




S25 


[nifiTupt Tfctor Ud>lc ftilL TTie majdrtiiim Jiumbef of 
u^fr-dc lined iiilcnupL hax^dlcES (16) S^-i' ilicady been 
LnsLallcd-, ihcn: i<i noi laaan tai incithiir 
[RLLOC_TNTPSBUPT CJlD. 


m 


S27 


D/O crmrt A hardwarG- failure has pievE3:ited proper 

>;I%M [niufer io dc fronn « disk <itr/vx. Xiw is a i^eriera] 
c^dr CDvcrini; many pouihic error condirinn!. 


1 


$ZB 


Kn devlc? coriirtFCted: Tliert Is no tk^ce in ihc slot 
and dnve s-pcdficd hy the given devLcc nirnibcr 

{nEfiE_ai.OCK, >JBETE_BLOCK, and VOLUME all*) 


J 


££» 


Wrilc-prolrctcdi Thp sfwcified vnlumc is wrKe- 
proctcied Uhc 'wntc- protect" taL ar natch an [be 
diskjackct h^« be«<i cnabte(J) No upetsiior that 
n:quire« wrlLing id &ic tlLsk cazi be pcdVinnEd. 


1 


$2D 


Invalid block address; An a,:ieinpi was made Lt> read 
dau from a RAM disk, ai an addics^s beyond Lis lintlis. 


1 


SlE 


Dish SWilCbed: Itlc reqixeslerl -upualJOn c-annu[ be 
pcrfcrmcd bociuK a disk crjnaluins mi open Pie fws 
been removed rrum Jls drJvc. 


J 
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f 




Woining Apple li driirea hous <t^ p>cirdM/a[» m^ihod for detectfrig dlEk 
switchw. This error It Iharefcuia rolunod wVy Whan ProDO? 14 
checks o volume nQTO during Itifr nonnal caursa of □ call Slrc& 
rrio5r cIbk. accsn calte do not InUoIvs a ch&ek el Ihe volurrie 
mama, a aisk-swiTched ©nor coti eaallv Qo undBtecrsd. 


S2F Dcvlct nflt fln IWe: A dcvjM sfiecined irt a caU Is nm 

i:(5rriecned. tn ihc iyilcm, nr 1135 no volumr muujlteJ 
on iL This error may bt PCCuirted by devace drivers Lhat 
tjn M?nsE! whethpj- or nOL a sprcifli: dcviirr l; Ort Ijni! 






$3^ - $3F DcvIcc-spniBc crrvni Ccnor codes in ihii nlA^ ^i^ 

w be defirwd snd uwd bj' jfwJJviti*4al device drfvcre.) 






I'iic cait ermK 






$40 iDvoLd patJuLOXDC or dnicc DBjnr b^tiIbx: Tlitr 
spcfiried jMidiname lit deiHctt fliirtic cofiiaJns iUcga] 
characlcra Cnlhcr Uian A-Z, 0-9. . ,/,■>- 






$4 2 FO! tabk- lulE: The Lubk uF ffc CCnwJ bl.xH u. [liII, 
the majLLrniicn pcrmitlcd number of open filc^ C^) his 
already been readied. Ymj may not open anirttmr IJLc 
(open call). 






$43 ItivaUd file T^eferencp numbcn Tlie specified nie 

jcfc^cncc number dcx& noi match Itut of any cuncnLly' 
open file 






S44 PMll itoi Faujid: A ^ubdiiFdory name irk Ehc 3pcE;iJi('4 
piLhnamc docs net c:xis1 (.the pathname'^ synLzn M 
orhsfwisfi valid). 






S45 VuhunF niM. fitnnit "The volura^ name: in ihe ipecirieO 
fUEhnsiTLe drie? nni i^vLst (ihe jitalhnifKie's s^'nraK ij; 
□(JicrwiiE valid.l. 






$46 rile iK)L foiuidt Tlie; lau flic name In [he ipedned 
pa.Uuia.mi! docs not aiisL (the pathnan^'s syntax is 
Ollwrw'iW wild). 






$47 DujiUcaLe pflLtmamei An aticmpc iMB been, made cd 

pathname CCRERTE, CHANGE PATH .calls). 




1 
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$46 Volume ivXU Sn inerapl CO dkH^Ic XAodis an i disk 

d^vjrje \]is fulcd, due to luck of splits tjn th« volvnw in 

the dcvitE tCElEAT^ , MRTTE calls). If ihlscmraccun 
durtog 1 wrjtt, ProDOS 16 nriiea data e untlE the dtsl« Is 
Mi, and &lill permJu ytM lo fAtxs ihe file, 

549 Volume dtrecuHT ftiUi Na moie space for t.fiu\ss is 

left nn [be WOiumc dijrclOQ' triHEATE calQ. In PtoDOS 
lifi, a voluciK cUfectOfy Cin hold no more ifaan 51 
cruthes. No mnrr fLIra can be addf d tr> rhis (Eire^ory 
until Dlhcrs are diyrj^iyed (dilcled). 

$4A VenJon erroi' (knxjmpaUble nie rpnnat> Til? 

version numl:fsi '\s\ ihe spwificd file's diieaaiy entiy 
does nat tni^ch dlC present ProtXJS a-PfciDOS IS flie 
rDTcnil venian number, ThB ejfOf can only fWftir In 

luluic vcisiaris raT ProDOS 16. since for all pfcsent 
vccslans at freliOS B and PreiDOS 16 Ihe file roffflii 
verelO'A number Ls zcfo. 

* Noto: The vefsitin nuniter rcfcn^d to by this effor cude 
CQflceciU [he flic fntmat ordy, not 111* veraion number oi the 
01>cralma syHem 3i. a whole. Jn pajliculai, it is LinrctalGd in iJw 
PraDOS 36 vcfSion number returned by ilie GET_VES3I0B 

caiL. 

S4B Uampponed Cor lucnrrcct) BUfragC lypH The 

□rgituiaLJnn of [lie speciTicd file is unknown 10 ptoDOS 
]6. See AjrpendiK A for 11 ilsi or Mild sroragc types. 

This cjToc may also be rtiumed if -i directory his been 
tarn|»rf!d wjih. ar if a pnzlls Yas beeA s^ tM a 
no ndi reel Dry file. 



S4C 



$4D 



$4£ 



End-oi'-fllt mcounlcTH) (out Of dan}: A lead hu 
bctn attempted, but ihe tunrcnt file position (Mart:) Is 
equal to end-aT-Etli- (EOF), and no fjnhej- data can bft 
lead. 

FosliiODi EHji of ran|K; [tie Specified file posiiicn 
pancr^eteF fMiik) is greaict than ihe sijf' of ihe ftic 

Access MOI alkiwcidi One of the a,[t[ibulea in ihc 
specifiefi lile's acce*) byic Forfcifb ihc aticmped 
OJMiatJDn iCrcnimtng, dCiLi'uyii]^ reading, or wfitilig), 
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S so f Ik 1» Dp«i: An laempt has bcm mide m pcifDnn i 

disalktwi^ii opcnlicm ofl sn open Tile (OPEH, 
cl[PlnGe_^PATH. DESTRor alls), 

$Si Dlreainy BtmctiiTe dttnaf^fb The nkimbci hjF 

entries u^Laied in tfie dlrcticiy header do« not 
maTrh ihe nMmber af crtrea llw tUredciy itnually 

Si2 Uofupport^ -sohiflie rj^Mi The spcdlietl volume la 

nai 1 Pro-DOS 16, PjoIXK S, or SOS dislt. ILi dicCiOiy 
focmal ia inwrnpalHric with ProDOS 16 

-Sj^ Panuneur tnil of rxn]^ The ^'aluc at ocie or morr; 

panmccnrs m Hie panmcicr Uodt La oul u^ JL> jiilkc qF 

pcrrrtlHihfc values 

$94 OmnrfMcnKwy: A ProDOS flpnaeraitLSpflCirieclbf 

Ihc aulT call L" too Lai^c [Q fil imo Itie memonr apiM 
available Em PtoDOS 8 jpplicalions. 

S55 VCB Ubie fiit]i The wWe of vnhimc conUtil DIOCW is 

^11; the. m^scimum pcrmiued nUEKber at aniux 
volumeK/ffciriccs {8) liiW ilicady been reicHed- Vnu 
nuy not l<hd inathcr dcviffi W *e s^iarem. The error 
occura when a devices are on line iniJ a volume oU 
a mj<)ie for anotttr JciicK ihs I has no apen fitftS, 

$57 'ttapUicaic vdIiuoc: Two W mjcw* cnllnc volumca >iave 

JdenliCSl vfllyme ditcctaiy i^imu. This rpessagc is a 
WMning: JE iJ'3*s nut fucvcril access ICi tfirher volume 
Unwcvcr, Pra-DOS 16 |ri» no way of kntrwing whii'^ 
vulume ia Intended \! ihc voluEne niunp W spcoficd in i 
rat i; li will icreas ihe Tirst one it rinili. 

&Si8 NM a block deriEB Ad attempt h^ tKcn made 10 

access a dcvi« that il tVDt i blHidt [Icvioe. C^iaini. 
V^mnns a( ProDOS \6 suppon leccaa to bloclf dentcs 
anly 

$S9 loTfllld Inelt 'nw value speafiecl r<r- ihe ayjtcm (Qc 

leirel is oul of rangt tSET_LEVEL oJD, 

SiA EkiCk aufidKT owl -pf ranap Th£ voliinw bli nap 

Irvdlawts ihil the volume cofiCairs. blocks be>t>rttl the 
block cuunl f-V fhn volume THs error may Indieatc a 
du judged dl^k stjciclufe 



i 
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i^B lUrial pithnafne Chblg^ The piithnimes en a 

CKA!*i3E_P)lTid call spcofy twi? dilTereiis volumes. 
ClfA'N6E_PATH tan moi'e Hie* a«nong direcloriM oflJy 
on the Fame valnrae 

He Not an exfrmtable Qler TTie ni« s.peciJieil in t QtJIT 

caE is ncK a Uutichable type. Alt applkatirwis laundiea 
bv ihc OLUT all inu.^1 he v/ps iB5 Ci'rciDos l6 
appOcjitlori!, JB5 (shell sppjiaiign), cr 5FP (ProDOS 
6 s^an rile). 

S5D Opffailng syAierWille syftecn not available] {IJ 

The atHT al] h^ii spicditicd a PiuLXiS 8 appOdcauon iij 
bs launched, bui ihc PrijDOS 9 operitlng jsyswm is not 
nn the syslertv dlit C2) The fohmat call Is unable lo 
rormat a disk toe the sjKdfted file sysMnn. 

$9 E: CaaatX ckallCKate /RAMi In c|iiLttln^ frCim 3 E>n:iDOS 

S-ba«d prDBJam and Launn-hing a PreiCi05 Ifi-hdncd 
pTOSmm. P-QtllT is nof able to i«<nov& the ProDOS 3 

RAM disk in hink JOI COUtl cillj. 

SSF R«lum Stock Dvcrfldwt An aucmpL was made tn add 

anniher IJscr ID Lu tht return stack m*[fi[iined by 
PQUIT, but ita: sta-ck already haj lii entries, is 
[EEiximL;in ptrrmiUfid numbef (QUIT ciill>. 

$6d Dua unavail^tK The 5>weni haa invalid infonnaiuMi 

■an -whirh davits wm Uat aci^sscd t5ET_tAST_DEV 



Faial efTora 

A fatal enur signiTies the oceuftence of a m^lftinclinn m 5*Ht.iU5 that 
processing miiEt halt. To lesuinc cja:cijti(jn folJtwlng, a fatal enor, 
you must febooi the sysicm_ 
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Hmtf»r WMMfi and OHcrtplkm 



I 



Sdl UaclBi™nl loirmipli An InlcnupL sijfi'Lal has 

iwmrpcd, ajud none oT iht insaUed handler 
dainuntSpOtlEihllUy ftB iL This cmX may ocoM LT 

|fl«srnip(-pn>Jucln£ hardware Is Installed before iL* 
assodlWd iiUcmipr handler ts illHjcaLcd. 

*0A VCS unliable: llie volumf continl bicck wWc has 

been daniau^d. The hUues of arrwln check bytes arc 
HOT whaL they flhfjulci hfif ao PraEMS I* tasmai use [he 
VC3J l»hlc. 

$0B FtB UJiUBable The Ale cdrflnJJ tjlodc tible Ills been 

ilama£cil 1"hc values yf eeitain theck liytcK arc ran 
what ihcy shBiild be. so ProKfi 16 amnoi uw ihc PCB 
[able. 

SOC Block irrtt iUbcaXed llJeifalljrt Writc-acce*5 in hlndi 

jcra un A disk volume lus been ttlBinptEtl- Bkjck wm 
□n all volumes Ls reserved Tw booi code. 

$0D Ifllerrapl OCC«rn:d whUt UO ihadowleiJi nffi Tte 

Apple llGS has soft s^Liirhp^ ihai LumioL s-hadawsrl* 
ftom banks 4E0 and 5E 1 lo b^(^|^I-t 500 and SC I If an 
inLf mipt oocum wiiite those swicdT^a arc off, ilit 
rumwjre intciTTj ^[-handlmg uode wD! net be efiahlcd 
Sec Aff/le II f^ FtmtwitK Re/erenM. 

Sii TTronBOiicrslcrti: '[he vcraiun twittilKr nf ihe (ile 

p 1 E or pB Is difTcTpnt foml the vcraLon nufftfccr oJ llii 
file PPODOS. PRODOS,, which lOids ProDCS iftCPlfir 
and Pid1X>S 9 CpA I , require.'" cnmpalibte vce.sLons Cl' 

bolh. 

[f a QVIT C2^ reiultf In Ihc kadlng of a PruDOS HJ-bascJ 
appELaiJcm ihat is tra lai^ so Til in ihc iv*«|ibtc memury cm ttui Tv 
some oit^r reason CJnnat be Icailed, execution hjSta .and The 
EollDwinfl mesBagc ia disfrfiiyed cm the 5Cfeeit 

Car't run ntut appiinotiaft. StTM-tCKWf 

where %xxxx 15 an ent^r code— typically ilcfA Locainr, Menwiy 
Manajej, or Slyiiem loader ercor cmfe- 



BooFttrap arron 

BfXTt'Urap errors on occur when the Apple [IQS inempls to EUn up 
a Pro[JOS 16 sy^teAi disk. Eimre cin oci^jc «[ several poinis in chif 

prncc^ii: 

1 . If [here U no disJf in the EUiiup drive, a 'abding appl;' symbol 
C '•~)appeajii. an the screer aJnng with the incssagc: 

CliDCIc atAiluir dnvlcal 

PI*ce 1 aystEm dJrfi Iji ihe drive and preu Corttrol-S-Rcsel to 

reMan the twol procedure. 

1. Ifih&rei«adi?diinlhedrive, buiUjsnolaPiotKKBDf ProTXK 
i£ sy.sfem di£k (that is, ihere is no type iFF file runcd peiqdoe on 
Jt), the ToUowlng rnesM^ appcam: 

tnjJiBr.E TO LaM) FRonos 

fiimnve the dIsJi irid replay jt wtth anothcf canuJniitg ihc 
proper Oka, ihen pfejs Coniral-Ci- Reset to rcstan the boot 

pmcedvire, 

h. irihc rde named PRODoS is taitwA, but anothcf csKnfil] file iS 
iiii55!rxg, 3 mesiafc such as 

HO arSTIByplB fkie found 



may appeu-. Rcmftvt; the rlak and replatc ii wJEh anoiher 
conisdning the proper files, thsn press Cantrol-d-Kfesa ic 
lenan ilie bcwi pfoetd.uit 

Antither type of ProDOS IS bootmap cmgi oocura on other Apple 
II sysiemi Ifynu uy lo boot a ProPOS 16 SfSlcia disk nil i standani 
Apple C i:orilj>ulcj- (□!«£ thai is BOtui Apple llGS), ihe l'oJJpaiF\g 

unot tatiiisp is dkSplavccL 

PftOCD:^ 1« flEOUIHES APPLE !lC5 HBHDKARE 

mien this iXOIES the disk will nut boat Vcnj cjfi boot aji J^ipfe ||CS 

System Disk Qrily on an Apptc [(cs (Ofnputci. 
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Syvtom toader errors 



Monrotai wrars 



NumMr MvfWifk and DwcrMWi 



$0000 



$1102 




(no CI rot} 

Hot fauuit 11(e spedfird scgntent (Jn the load fite) or 
BMiy On the PiUhiume Tabic or Memcijv Scgmt™ 
Tabic) dOM (Wt eaisL If [he spedScd load fqle Jtsetf ia 
!»[ found, a. ProDOS l^ enat S4^ (fik iiot found) i9 

returned. 

lit«Miipatililr OMT nersloD" TTac ob)e« mfylLilc 

rnrmit vcriioH afa Inad segment Os spcdfieiJ ict lli 

header) Js irvcompaliljlG wlih the- currartl verelnjfi oE the 

Sysli^m Laadc-r. TTie Iwder ■ftill nut load sucti a 

scgrncni, 

Hie J« cKit a Load Ota Thi; ^xdfied llo«( fUc is ck« lyi* 

S&3-iBE, fee Appcndir A w D (or (fcscrtpdons of 

these file lypea. 

liudcr Ifl busf^ The call annQl bv- made bedose the 

S-yiff ni Lfadcr is buay wIiJi anotbri call. 

FJIe ^nskia cfrcHT: The apbO-ficd file cannot be 

loaded bctauac lis creaUan date ard itme da ikA mawh 
those 0(1 lii eniry in ihc Pathrmrru; Table. 

TWa error applies to run-ttaw iajraxy files atty. 

Uaer ID eiTon The .speclTLed Usci ID either docsn.1 
ciisi (ApplifMion ShLJtdown), or doesn'* Jiuttli [be 
u«f ID (if the spedfted segment [Unloid Segnwiw Bf 
Number). 

SegNuiD owl *if si^uMice! "tlie valiie a( the SEGHira 
Jldd In the scgffleni'-S header docStli'l nutch the 
njmber Ijf whidi the iegmen( was spctiTicd OiiaiJ 
ficijmEat By Ntjmiw, Initial Ltud). 

flli-gal loud cccard fcnuut A rcco^d in the Moment is 
of 1 Vfpe not accepted by the Li^def. 



Siton Load segmcQi is TorcCKnT The values m tlie UUMEEX 
i.nd NTM^Eiti fiel-ds in ihe spcdfLcd scgnumi's hcadct 
ace not and 4, rtspeolvcly CUad Stgmcrt By 
Number). 

SOOl-SOiP CPraDOS l€ I/O CfrOH — itt •PrdOOS iS Etinir In 
thia appcndiK.3 

JZOl-JIDAtMemifry Mlnagcr eircia— s^ Apple fliS 'SoT^box 



Fatal enora 

If a tfi'iPUS !& etrar ai Memnn^ Miniger error OCCUJB wllilti the 
System Luadcj- Is making ^n internal call, Lt is a fatal crrar. TTm; most 
ccimnKTi case i^ when a Jump Tabte I-Ofld la Sltecnptcd for a 
dynimit Load seBJiieni Or runtime lihtary ECgracnt whose voltuse U 
niH (HI line, Control is transrerretd to (he Sysierrt Failutp MinaEcr, 
aild the fnilowrng nns^ajjc appc-ara on the scrcejt 

Sttoi lasdlnq Dynjiilc m^qtitf^K-XXXX 

where XHXX Is the error rode of the PfoDOS l6 or Hcmory manager 
ertor thai orcunctL 
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abSDlutci ChafiCterislic af a load s^gmciiL ov 
oihnj program code thai fmiai be loaded ji a 
specific address in memory, jrid ne^ici muvci 
Cora, fw re reli>i!HiablE. 

acxcsR hyte: Aji aiEilbuCe of a ProDOS \6 Die ttiai 
delfrmincs whai types ol □pcjatiuns, audi as 
rtjdlnfl or Ofiiling, miy be perfomied cm the file 

arcunrnJatan TTie rejjistcr in (lie micfapioicssnf 
where nw5i ■fompylalions are p^rfoimcd. 

xddressi A numbef ihai specifiGs rhe location of a 
bsngjc- bylc -uf mcmoiy Add/eiscs uji tK jjLv*?i is 
tSctriiiiiLl or hcjudecntlil intcBcrs. TTie Apfrie IIG5 
has iddreascs ranging rroni lo 16,777,215 till 
dediiwl) ur from 500 tW OC to SFF FF Ff Qn 
heiarfccimiB A compOcle itddre» coflsLns oF 
I l-bil tdiLk oLimbCT (iOD lo IFTI Mfowrtl hjr a 
16-bii aiMrws wj[hin t^ai 'bank CSno no w iPF VF). 

Appit DCS Prtrgmnimcr'5 WOi-JiSbdjH The 
rfrvctopuicQi cnvifdninenE for the Applf ][CS 
Mmpulcr. IL *a>(isisi5 of a. SCI oF pitipsnu «hat 

fadlitiie ihe Vfudag, campiLtag, and debu^mg dE 
A[>p]e 1IC& applLcations. 

Af^UcBUon pr<i|{ram (a( aitpUcBtlaoJr (jl A 

pff'j^rjrir dsat pcffomis J spcQJic tisli uicFul to the 
Lvmpulef LjJiec, such as wftfj processing, diit* base 
minaseinipnt, ar Bfaphicit. Compare cAnu^tUug 
prajiram. ahell appUitation, syiiicai pnngrBm 
ft> On the Apple UCS, a pfn(;ii.m ittal aetesse* 
PidlMS Ifi iird Ihc Taolbos dicccdy, a/i4 [III! can 
be called or lycirf;^ via ihe QIJlT call. PmDOS i6 
appQcatloru ire BIe lyp« SBJ. 



Workllioip. 

AFW licim The Lmlief sjupplitd wiih apt, 

ASCD: Acronym for Amencon Siaadani Coiis 
far InprmailOH /riltfiEhangs. A fOiie in which ihc 
nunibcra tuin u* ]27 stand I«r icii chajaacrs 
A5r_n ayit is used for n:prcM3nLin,J lesl inside a 
L-i-iFttpulcE and For iranaminirMj. tCKl beL-w:en 
Hjumputcia at b&M^en a computcf and i 
periplKEii device. 

asscmliEeft a program that produOM Db{«Ct 
Klea Cpiograms that conuirt aiithliicAaw^wt^ 
codc^ t'com Boune Bin wiitu^n in du^jnbty 
Unguage Compare complkr. 

AuxID; Que □( three rielJs in the L'Ber ID, a 
number ihal Ittentilics cich appJicaUon. 

bacJnip bib A bi [ m a file's accrsa l>y1e ihac idls 
hidojp programs whaher Ihe Rte has been altcr?d 
Sinu: the last tiiiK il vris badcrd vip 

hanlt: A fAK. ffi^.Mfi-byw) pOrtiun of the Apple 
|[CS inlema] meflnory. An LndEvLdttal banlt Is 
specified \rf the value of one uflhelSiCaiS 
fFiitraprocessor's bink registcis. 
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buih'Swbcbeil mcmiin'; On Apple [] 

computers, thai pifl rjf ihe langaBge CW^ 
iTienKiry Jn v,^di two ^H-pondoKi of mcmwy 
share [tie same addirss range (SIXKJO-JDFFF).. 

binnry BIei Cl] A TOe whrsA tixa. U ta be 
intcrppctcil in btnifv form. Madii re- language 
prt^fTiirtLS and pittuica arc Stored Jn binary RlcS. 
Compare l«!0 flJe. C^J A ITle in bliiary Ble 
fomuu- 

Mnary flit fumuK 'i'tke PrujtXSS 8 luitlsWe Hie 
furmW, fiUftslsiLTLB, af one nbsoluie mcmorv inuge 
along with iH destination address. A f Je in twnaiy 
nie farmit haa PioDOS file lypc JO* and is 
lerejred lo as b bin lite Th* System Lcitfer cannot 
load BLN flies. 

bit A coriractiron oT btnary tilgU. The amatleat 
liRil of infofmstinn that a computc^r «n hold. The 
ifliliic af a bim oi 03 rep!«sents a ilmple two-way 
diolte, such )is ves. m no or on oi ofT. 

Mt ma.pi A Kci af bLta thii represent the pavilions 
arui aai^S nJ l corresponding set ui i'^irKi. ^^, for 
example, siobal p^nie bli- Euap □[ Tdiudt bit 

block: iD A TiniE of diia acofage or MJisfcr, 
lypidlly 512 liyiea. (2) A cartlguouS, jajte-aiLgned 
region of compiite* mftmnry -nf arbitrary aiM., 
allocated by the Memory iMirtagSf. ALio called a 

block dpvteo A dcrvicc that IiBnsr«(3 dili4 to oc 
&nm a cDrnputer itt muklple* erf one blcck (512 
byi^J of chajactEiTs at a time. Dlak ilrives are bJodt 
de\'icEs. 

boob aoqiIkc way vn say ^dn i^. A ciimpvi;^ 
brunts by loading i pfOEfim intn tncmDry Jrum an 
'SXitifnaE stons? mpdium audi a5 a disk. BwM is 
short For booHtiap lead Sianina up ls often 
accomplished by firsi Itwding, a small program, 
which (hen rt^idi a laE.gi::r pfugrlm itllO nieTlory. 
The pragram is laic] to 'pylL IfselJ" up by its own 
bbfltstrapi." 



buffer'. A rtfBlon of memory where tnXorniJhWi 
can be itorcd by one program or devits and \h£.n 
jcad al a dilf^fent rale by nrwMher. foe eiRunple, ■ 
Pf nCMDS I* I/O tnifTcf. 

Busy wdr^: A rirmwiTF flag, Mnsulied by ihe 
^diedulEr. that prcKtas st'slem sofivare ihjl Is 
nni iccnLraiii Ertim beins tailed while protfessinj 

smiW.'hef Mil 

byiet A unit of inftynmalipn comiiiting of a 
5eqiiertcecirflhlIs..A byte can tafce any value 
between and Z55 Hid and JfT hesjdcdmaJ), lis 
viJue can [epred^nE an IfLstnioion, number. 
diaiaCter, oe losleal slalc, 

■[■a ll, (v.) To icctuest the exEcuiian oT t subrauiioc. 
fuiicEitJrt. Of prriceduie. Cu.) As In operating 
system calls, 1 *equC5t from ihe keyhnaf d or from 
1 pr^_Htram \o execute 1 nanKd furvciion. 

call block] The sequence oF aEscmblyUnguisc 
inatmoions used to tall ProOOS 16 or System 
leader (uncLiLina. 

catty nigf A Status bit in (he mitrnpioccssor. 
uwd as an lEidLiitmal hlgh-oi-dcT bli with Mie 
atcumtililOf biw in addition. aubtfaoJon, 
njiatlnri, and shift O^XSMlicns- 

characwr! Any .symbol ihil has > v'uirtf 
undcrslDod meaning and thus can convey 
Inrurmallon. Mmt characters jf^ repjrscnred in 
the computei as tine-byte values. 

ehar^ntf device: A device that trinifcia data to 
Of from a rompuicr as a siream at Individual 
dharadecB Ke>'bo*fds and piintcri are characta 
devioes- 

do«ci To tennlnaie acrcis to an iiptfi Ttie. When a 
Rle \S dosed, il^ updated veTSiOr IS- written 1« dt* 
and all .resoura&l Jl nemfcd when upcn {s^ich as its 
L'O buffert ace released. The flle muil tic opened 
hsfcue it can be accrued agaJi^ 



aid 
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fOmpHcti To icarranBc artncaied memory blotk? 
in CifJct tn Increase Ihe Imnunt nf [:onlisLjfflis 
LiEtalloraLed Urce) mcnmry. The Memury 
MinssEJ- compacLs mcmury vhf.n jiccded 

compilcP! A pnfgram rlu[ produoB ilbfKI fllM 
(coniainirtg machLn^.languaijie code] Trom 
SDUf « flfcs wjnien in i KIgh-level [inguigc audi 

as c Ccrnpiic- asuemblcr, 

coBiraUIng pritwram; A program ihaf loads md 
mm iKhet prej,gncns, wiihout lEsclf relinqu^Wng 
conlnal. A cijnlrotUjiB prt>srBm a rtiponsihle for 
shuiUng down Li s Lib programs ind fiwing iheir 
inemory space wtien thqy lee njii^heJ. A shell, for 
ewmptc, La a corlralEmg piQg/aiTi, 

oreadaa dale Aj:ii jKribute oi i PiaDOS ;6 fELc;, 
iLspeGftes ihc {faie on whidi iJic TJe wm fusi 
oeatKi. 

matloQ Lime, An allribute oT a PfoDOS 16 (Ite: JE 
Spctifics this lime al -whifJi fhn FUc was firw created. 

tiuTcii applin^U&iL' Thift ipplicmcirt picgnm 
ajmentlylosdedind ftirui[nj5, r^'Cry ippllcaUon 
piOS/iia Js itienliJjcd t*y 3 User Hi number: the 
current appljution y dcJ]ne<[ jj Lhai ip[di'ca[ion 

whcse User ID IS [he pnaerti vaJw trf ihe USBRID 
global varL2.bl£ 

dam blqvlu A 5iZ-l»yic portion of a PrnDOS 16 
aUndaA] fllr ihai consisss of whalcvwr kind of 
itirnrHiaUon vhe [itc mjv conlJiin 

defaul! preftc Tlie pathfumc jireHi; jtiachedi 
by PraDOS 1^ Loa [lonlal pathitame when 

no pnjflx DiunlKr J5 ^uppUc-rf by ilie applhcaiion. 
The dclaLiit prefii is equnnLent la preiU 
number ,* , 

dcreewencc] To •uh^lcuir a pofallci- fnc > 
memory hanrflc. Wlicn ycu ilceeferrncc 3 
memiiry hlotk'i hajidle, vrsu aita? Lhe block 
Oiicaiv (Lhrougli jis maser polntifr) ralhci ihan 
tadirE^tly CrfiroLifth its JurtUeJ 



dealt aceessorJcai Small, spc da 1- purpose 
pTQgranu that ?re iviiiahle 10 [he ii5cr rpiafdlcBs 
of wKltti 4pp!Ltaliofl I5 rarmlnfi— sLich as the 
Contra] Panel. CjJailalor, Nuie Pad, jnd Mann 

docli 

detkujpi lhe visual inrf rfif^c bct\w*n ihc 
iompuier ard ih^ usrr in computej? tfiji supporr 
the desktop ronccpl, itjc desktop consists nf a 
menu bu- al ihc Cop of the soeen, uni a gray bici 
in wtiJc:h ipplicauons aic Opened as windows The 
desktop intcffnre was fiist developed fof ttle 
Macinb!vh cjinpulei, 

4ni<X: A piece of equipmefll Qiardnnre] used in 

CCJnjunctigni wilh a. cnmputcj and wufcr Ihc 
compu-lei's canlm] ^so called i ^rlphjval 
dcvfc« because sudi equipmcril is olten phyatally 
wpaj^aic finin, but anached mj, the CQEnpu^c^. 

dciriue ilrlTcr: A program thai mutages the 
Lransfcf of io^DmiaiJon between a computer ind a 

pcTiphcrel device, 

dlttti page A pajK (25* byied of bank Jiaa of 
Apple IJC-5 mcmuT^ jny part of ■which can t» 
addressed with a jshoa (nrv: byic) iddre» because 
lis high adJiess byte U fth^yH SM and ila middfe 
iddics^ hj.'[c Is the viluc of lhe t5CB16 dlnct 
jeftlaWT. Co-resHlent progfjtii! or routines aa 
hivs iheir Dwn dinai pajjes u ditfcredt Jr^cationa. 
Hie dirca page craresponds to the 6502 
pio«!saor'.5 zcnj page. The wmi dirsapagea 
often used .rirorraally (o refcf to ley part of lhe 
lower pofdon of die dJcKi-page/staek «pa<:«. 

dlfwi-pagf/iudt spaoe: A pnmor oJ" i^nk JOO 
of Apple IIGS mt;mur>' rcsen-fti for a perjg^ram's 
direct pane a,nd BCafk. ri^iUalty, The 65C9ie 
piDcessor'a dlreCT Kgiii'tier eCMlUirts tte base 
addreiS of lhe space, and iLi Staek rvglstCf 
contains ihe bjjhesi addn^iss, \n use, the siadc 
.B^ws downvranl (rom the top of [tte direa- 
pipi/siaiJc spuoe. and the bwcr pan of the qijce 
conEains diiect-pifl? data. 
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illrrct rTg^tcR A tiardwarc icglster in the ti^CSlti 
pfocfssoi^ that spefitei itte stan. ot ihe direci page. 

(lire<*jfy flift One of the rwo pfifvclpal ategories 
□ rPn:nDOS 1 6 file?. Dlicclory fllca contain 
jputMrcallfT Forn^ned cnlries that (omjin ihe 
names and dLsk localJaiis of oihcc files. Compj.ir 
$taiu]^ird [Uc DLrectQiy rLl<>^ ar^ '@>'[h@' voLuiac 
dlreachries as Bubdij^CLarles. 

(Usk dcvief; .fpt? bloeh device. 

disk npcrailnB syracm: .\n ofierailrifl .syfteA^ 
whiHC principal EuncLiDn \s lo ma.nage files and 
communication, ■^■ith one or matt dish drivts. 
DOS and F/oDOS aie two (ojnilies of Apple H disk 
opcratiitg jysLeni; 

dlapOitf: To pcrmajiently dcs-llociale a mtmor>' 
binck. The Mi;iTw?rv M'sn^^r dispcees of a 
meiuury bludi by Temoving its master jxMrier. 
Any luedle to that polnier will thfiii be Invalid. 
Compare purge. 

(faKTnoaL Said of 1 |>ragnm lihii Li tv>i tKing 
exetJiJied, bur whose tssfrttiaJ jiarts air all in ihc 
CXunpulei'a mcjxioiy A dormant pio^m maybe 
mvtiddy rwtait«d twcaiAse ii need, nut be rdoadetl 
rrom disk. 

TXJS; An Apple U ilisk Qperaurvg syseni. DCS is an 

acronym for IJisk {^ipi?n:^nig Syii^m 

dynHmic HBineDti A scgmeni that can be 

[traded aind unloadi-^d during enccuilon »s tvtbAcA. 
CoctLpare auiic iejmfti.L 

c flag. A Hag Wt In iJie ftCBie thai delcmiLnes 

wheiliei 1 he processor Ls in luUrr nuHie or 
emKilatlon nrtodCL 

)^b9l Apple H: 3ev stuidonl Apjilc IL 

enuaUUoii mcKJe; Tlw 8-bit cutklTguratiun of the 
65Cai6 prtsccsfitjr, in which it fujioions like i fi5ti2 
prcKS^or Irs a]] s«Spc<SA excepl dt^ck speed 



EOF (end oPflle> The lofica] eti* of a PraGOS iS 

lile; It U the number of tidies ibiki tna.y be read 
frrwn or wiiJlcn to the Rle 

ftmr Uit error «tndtU<Hi!i: The state of a 
corapuicr aftci it has detected a fEull in one ot 
nvQie cumiEUnda Mill to Jl. 

error codei A n« mber or ■olher syn^bol 
rcprcseniiing a type □feircH'. 

event; A nmiJl(ari«n 10 tn application af same 
occunvnce CTach a.s an InEemipi generated by 
a keypress) thai the applicaljun may warit la 
itspwid w> 

cvcnl-drivGiii A kind of pmgnam that responds TO 
user inpuii in nal irttie by repesiedlv irallnjj Sjr 
events posted by intcnupt [ouilrics. An cvCiU.- 
driven prDgram doe^ nodiing until il detects an 
evETi such as a licypfess. 

fitfttoA dn^M: see dertcc 

taial em^rt An. Mirror Koou; enon^ that lhe 

compuwr must hall e«*cu[ion. 

nieE A najned, cirdBied coLlectlan of LnTaiTnatioj] 
Bioted en a ttisli. 

flic oooual bkwk i>'CB> A dua umcture sei up 
in memory "an protiOS iii 10 keep tnteit of all open 

raes. 

Die eauy at die dtHCtory emry; '[Tie pan of ■ 
Prt>DCB 16 diiecloiy or iubdircirtory that 
dficriijis. and points V> another fifc Tbc file so 
descnbcd ii ^Qiisldeired to be 'Ln' ^ 'uru^r* ilmt 

directory. 

nieievel: A«v)«ieiii die hrv^l. 

Hlenamr! Tris twing of ch:4r3'>;wrs that Identifies J. 
particular file wiihJn its dircctofy. PrcDOS 16 
rilenimes a&y be up 10 15 characters long 
Compaie paihoame. 
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file symem IDs A number des crib Lug [he scnera] 
ca[i£fif>ry nf f^fiiJin sysiem co whldi a Elle nr 
vohjmrC belongs. The file syslrm ID ia an inpj! ti 
CbE! PioDOS liS FDHHAT c^, sfKl a result from 

the VOLUME am. 

mc (ypti Afli auribute In 4 PrcrDOS 16 fife'* 

diECLLcirv ciiLry thai iduiacicnzc^ Ihe txxnlenlj ^f 
liH^ nie and irxHtais how [lie fJe nuy tK used On 
diiik, Tilr lypes arc siDced bj numbed', in a 

ctiir^iCLC'r mnemciiiic codes. 

lUlciR cans: Opwatin.^ (rsierti dlls [hat 
mar.LpLili[c lilc5. In PrnDOS Ifi, (iiixig ca[Li jre 
^bdivKted inicyrie Jfcwf£\bE'^d^£dJ^ArHi_/1[e 
Accisi nalb. 

Riidrr. A pcogEiEit [hal pcifcinna Clc and disk 

uttEiLi^ (!'o[n]ai[lns. copying, reniming, and sa 
on) aiid also stom appLcatlcns a.t ihe rcqufsi of 

Che luet. 

Armmrct Prci^TMn; stored pemiincnlJy Ln I^k 
eompLiser's nead-onlr mccnGry (ROM). Tbry can 
be cjTcojlcd a1 a.Ei]f time but cannoi tg mfrflJlirf OC 
crajicd.. 

fbinl] NgL Ditii^bLe Ln mecn-oTy itrvx ftLlociiedi 
AlsQ called ufimpKjiifc, Program .sp^menu ihai 
rnij^t ]ii>i be muved are pliced in Eixcd monKuy 
blocks. OpposiCc of mavablc 

Oiisbi To uptiijw jn Open filr Cwriiz any upc^icd 
itvTomiaUcn to disk) wiiJiDut clnislnj li 

Bbrtial pXgC; Under I'mDDS B. 2^ byles rrf rbta at 

sv5ism Infurmadon tsudi la a list □(" ictlve 
devicta'i aviiiabLe !□ any ippliracJon 

XlnTial ]]a(^e bit raape A poeijan of thi? Pmix^S 8 
jflilbal page iJiaE keeps tridt nf memory osc in llic 
enmpuief AppiJCJliOjIs under PrtrDOB fl ajc 
rfiSfMr^W'blr tnr mErbing and clearing pans of [lie 
bit mip that cofcespond [0 memoiy Lhcy have 
ai]cic«ed Of rr>Md. 



guest flfr sysirai; A REe cy^iem, other 
i}un ETi^DOS ]'6'i5, n'hoie fUcs can be lead by 
PiDlXDS 16. 

handlci J4?(; njemory Iiandle. 

htyildfdniali The ta.w;-l6 system cf numbers, 
Uisins ^he [en di^[s ihiDugJl 9 *rtd [l*e Hi leltera A 
Through J^. Hexadeclnial rwmbets «n be 
CDnverijEd. canity and dliediy to biiiBii> fLirm, 
because each heii^dedivial dijii fflfrajpnnda lo a 
scqitcfice cf f<rui biu. in Apple nunuak 
Incudcclmal nunitKEG itc usuiiJLy pn^Dcdcd by 1 
daOar sign (.!<') 

UtnrcMal tUe syaiera: A r[ie[hod or 

oi^mlzaitirin. tn ik'hii:!! disk tUcs ^xc ^guped 
lujcdicr wiLhln dLr«i:u>i4es ifod subdltectocifs. 
In a hl^ruiihiui (U^ jiy^tcm, a [ih: 1$ spcdficd by 
jis pBihnsme, richer iJrun by a sjnijte fiierome. 

Klgb-DTifan The most signilieanl pail at i 
nviTi^Ol quantity In nnrani] rvpK^pntadan, Ihe 
high-OEdcr bit dE a. binary v3.LiJC j> in dic^ ler[mui[ 
poslUor- LilcewLse, the high-order byte of a binary 
word or hirtg word <}u:iniicv consists of ^ 
icflmcisS cighl. bUs. 

Riinun Interfiuc Guldellna; A xi of wFt-waic 
develapnxm suLdielLne; develapcd b^ Apple 
CompuT** (n su.ppof[ ihe destaop eonc«p4 SJWl to 
pnimoic Tinifiiinn user inwuiaccs La Apple d tnd 
MaclnLnsh. applJi:a[I[»u. 

Inuga A repreurtU[iQrt of [he nsAieaii of 
rru^mory. A code Image eonsLsts of mictttne- 
lifigu-aje iiisuuaLon^ of da^ diJi miy ht loaded 
unchaiijted into mcniory 

Itklti bhlck; A ^1 3-bylc part of a I^DOS l& 
standard file Lhai [:an;Jwi erttirely qf point^n. tn 
ot^icT panis idiu bkxio) uf the lile. 

loltM liHid iUr! tlie n na FUe of a pragram w be 
IcadcJ ■n[u mcmoiT- I[ canCaiins [be pr'USlam's 
main segment and dK load fkle tabj^ Qunnp Ta.bl£ 
Kgment and PaiJi.name £«grtM:n[) [veede4 to Icud 
dynomit: segEiKn[i' and iun-[unc Hbraiies. 
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ItiJ Ha ll-ratfti rt oegiDeFIt; A 5r!gmen[ in nil InJdal 
Loaii flte lh»[ is loaded aiid AjtecMted 
independendy of tf«e ccsitrf [he pr-^.^irv. It a- 
■cammtinlv cxeL:ut'ed firH, «o pprfarm any 
inJUaiiiSlfon [!>»[ the pcoBiiin frtjy requitE- 

Uipnt/DutpiUi The iransrer of i3i/orma[iDn 
tieiwrcn a coEfiputcr's memory and peripteia! 

iDtemipti A Icmporary suJpecHiDn in [he 
eiecu[iQn of a piOfiii™ that aHows the compulcr [D 
p^form seme ciher Cask, typJealty in icspotue ro i 
Eignal Irom a <tevipe nr aouice ci[[erail to the 

miTipU'lCD. 

hiiemipl haiiUfn A program, issCMdateJ wldi a 
particular cmcrnial devfooi dial eBstutcs whenever 
iha[ dtvjM sef\(iA an In^irmpt signal [o ihe 
computer. The intcmipi tiaddlei pcrforma ia lasks 
during cbc inKitupt, then returns contiol [& live 
COmpyier so jl luay irsuuic prO,gDi"rt execution. 

IfUHTupt veCKir table: A wWe mainSaincd in 
merrwry i>y PraDOS 16 lltal tonlalni dw addresses 
Bi alt currently active (^llcjtaicd) lnicmipi 
handlefs. 

[NTSRSEG neardt A pact Gf a relocatlofl 
dictionary. It ccntiiri!. iFlofraliOn infoawation Ear 
cilcma.1 Onterse^neniJ f^Ecrcnccs. 

I/O: Ste lapnVaatpiiL 

JHl( Untondilignal Lonfi Juiiapi a 65C816 
assembly- language op ««!«, It takia a 3-byte 
address operand. A JML car reach any address in 
theAppEc [IGS msmovf space, 

jMPi Umx^nddtiocuL Jump^ a 6102 and 6S<31^ 
*Membi If' Language tsp code. It iaiics a 3-byie 
address operand A JMf can reach addressee only 
mthlri i jingle &IK hank at ihc Apple l]C£ fnondry 
apace. 



J5L; Lurigjymp to SubiOutlne; a ^5Cai6 
aisembly-langjage op cade. It tlVes a 3-bytt 
addre.S5 [ipecand. A ]St. cm access itlv idcJrraJ in 

[he Apple llGS mi-m cuy SpSCC. 

^SB; Jump [o Subroy[lfWL ? fiS>2 and 65CS1* 
asscmbly-lariguase op Cddc. ![ la^ics a ■Z-by[E 
addre» operand. A JSR awi access addres-ws cailv 
within a iingle 6IK bdnk of The Applfi IIC^ memo^ 
space. 

JiiOl]] T;*le3 A uble tofiStfuetcd in mcmoty by 
the SysLEm Loader fram ill Jump Tatjtc stpaents 
eneouniered during a koad. The Jjmp Table 
ctintairks ail feferenfcs tn dynamic segments [hu 
miy be called dimrjg en^cutioti of the pragiain- 

Jurnp Tabic Alfreioff: a misier lisi Ln nwrnuiy., 
conlainin^g poinieis 10 all scgiriCikU diaE make vp 

ihv Jurnp Tabic. 

Jump Table a^BiDenh A scjjmcjii in a load file 
Lha[ Mrtiiiru! afl. indicrerices [o dynamic scame-ms 
that may Ljc oIIkL (hiring eiemtlan oJ that load 
file Thejwmp Table scgmeni Lf oeated Ljy die 
linker. Irt menfbtwv, Ihe loader combines ill Jump 
Table seginefHS 11 enenunlcra in[a Ihe Jiuil]l 
Tablr. 

m KHotoyie. lOM Cl^°i byHa. 

Iwraeli The ccniial pan of an npenting sysam. 

ProDOS- ^€ 13 ihe >Ernc3 af die Apple 1 ir.S 
Operating system. 

>^ lilocki The liis[ bloelt In any ProEMS I6 fUe. 

kind: See S«gfnent kind. 

Ikrl^uage ttrA Memory wlLK addreascs between 
JDOOO and JETT-T on any Apple- n-farrwly 
COcnpulET. Il uVdudes C*0 RAM bariks in [he 
Jl>jnT Space, tailed bank-swltc&cd tarooiy. 
The lanauage card was oriaLjiaily a peHphenl 
card for (he '\SK Apple H or AppM il Plus that 
expanded Lis memorv cipadiy to i64K afid 
provided space {di an additional dlalccL of BASIC 
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level: Sea aysccQi file ItveL 

Hbntry flle; An objtKl File ccnUirtlT^^ pmgram 
Kerrwnts, eacln of ■which mji be usttl m iny 
nunibor of puc^ranu. The LLnlicr L^n .scudi 

beer n^lcicncHi in the prograrn source liLr 

Ufiher: A f<^ugram chac coMhlnfts nies ^nenicd 
!3y CGmpilm and assf mbLcn. rcsiojvca all 
^ytrihirilic feFH^fcncra, andl jp^ncraics a. [JJc Ihal un 
h^ loa-dccl inEn mtrnory and c^efuletl. 

IohI file The t^tput of rhe linter. ijjid lit? 
cx^nlaiFi iiiGini:if>' icnag^u thai the syiiEcrm ki:i3.[lci 
ran Lujd [mu memwr. loeeilw? ujiih T;elpc»ii!>n 
dlcUaoarJes Lli3.t Lhe leader use: \a icIociLe 

liHid KegmeiUi A scgnHni tn a load ^. 

IfH^ Td pm*tnt a mcmnry Wcick Frtim (Winjf 
moved Of purged. A btodc may be lartecd of 
unlocked by ihe Memory Minager, of by an 
appleiratLDn EhiaugK a call Id the Systirm Loader 

long word: A. duublc-lcji^jJi wijid. For [he Apple 

]JG6, a lang WQ[d Ji^ 32 hils (4 b^'tus) Innjj, 

kiiw-airdert The Icasi ^igalflcam pan cf a 
numciicai i^niJcv. En rvnnna] rcpcc^cnLiUDn, the 
ICiw-iader bit oFa blnSry rluriiber iS en [he 
jljihtirciEi pnsiiicini likewise, the Jaw-nfilcf hyie rtt 
» binary wofd or Bang v/otd qusniity c^finsisi^ uF 
UiD rij^htmcul eight biti. 

m llaRi \ .flsg in ilig ^5C&16 pracessor Ihai 
d[;u;raiilncs wtiethcr the zoziimLJlatDr Is 8 bits wide 
nc 16 hlu. Q.'ld8- 

maiTt}; A single pfcdcAtted ai^scmbLy-Janguagc 
pscLida-instniH3Jon iJiai an auembLct re-plw&5 wirh 
severe] aflual jralnicflii^ns Ma-cruK ai^ almu^L llJcr^ 
highfr-tevel jnstrvirlJctrs thai cain be UiS*i injMte 
a^^!llb1y-lArigij)tge progranui, mlkLng them easier 
[□ wntc. 



MalnlD; One tyS^ thtnt Fields En the User n>t a 

lumber thai idcnliEl*,* eich ippHciliar: 

m^iln. tiejpamati The lirit static segnteril Oxher 
Itiin iiuLilLiiallon MgrncntsJ tn the inlUal JoaU BIc 
liT a prtiBram. It l^ loaded M Stittup ind aever 
fmrTufiV^d fnMti meinarv uiUlI the progrlnl 
tcnnirH.tes 

Mark: ~itK aictcfii pt^Ritlon in an open file. Ii Is tb« 
poinl in lhe fiJe al whicli [he ne*T rsad or write 
opet^Unn will occur. 

ItaA Llstt A tabte mdinlalncd \i\ mejTtOty trf The 
Sy5icm LoaJci To help Li perfofm relocation 
npl-dly, 

maawr tnden: Uock The l<ey Wodt in a PioDOS 
1() tree CIe, the iaigcst oqiMiililiOt: oF 1 
siandard flle ihn Pr<iTX>S Lfi can support. TTie 
misia Jfiijcs blodE cotiststs solely ot paintecs id 
nine or I^cl^f^ IfldfX bkkcks. 

(Tiaster polnlen A pointer tn i mcmury blotk, it 
i.1 kcpl by Lhe Memory Mstiigfit. Each aJtocatiSd 
t^if^iuncY hJnck hail i master peunter, but the blcclc 
ii noimjlly accessed thiuu^gh ifs ijiemofv handle 
(whJch paints Ie? tbc mmlci' poinlcrj, calhei' ttafi 
LhrciuiBh the masier jmlnier itself 

Mlti Ms^hyut. l.tMB,S76 O^'^ bytes. 

memory' bliKki Six biodk (2). 

memory handle: Thr idenliiyjng numbef of 1 

particuliT bl-L»Jt of memofy It is ? prilntr^ in lhe 
ma&ier poiruer iO' lhe mcmniy bicjck. A hinillc 
rathcf than a simple pointer is needed io referenus 
1 moveable miemory bl-odci ihal way the handle will 
always be lhe same though the v^uv -iif ihc poinuii 
may change as the blod^ ts moved aKTtind, 

M«dtcii> Hafljgn^ A pfo^m m ihe AppSc IIgs 

TodHw* that manages mtmory use The Merrt&ry 
Manual keeps traii of ho* nwrh memcry 1^ 
available, and. alJoeate.'; meniDry bltHlte tn hold 

progiam acgtncrat Ot data. 
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Hcmary Sv^nKcnt Tubht A lltlhed list Jn 
msmoiy, created by the ]o-jdec. that alLciws the 
loader m heep track ciE lhe scftmaiB thai have been 

loanjeij inio metrtory. 

Mils M-achLne Umgttai}e ItwerTace—rlie part of 
?foDOS 6 that proccis^ Dperahng sysLem calls. 

nUnllBcatlon dat^ An UtribuM Of a ProOOS 16 

file, il SgiedJiw ^^e date on which thrc ctmlcnl d" 
the rje "w^s last changed. 

■mdlAcallOtl lime^ An allnbulc at i ProDOS 16 

[lie; il spccillcs the time al which di^ i;inile[K of die 
fQe »u lui cringed 

monlion ^es video monlmr. 

HonUei- program^ a prognm buJtt inlo the 
CinnwECE of Apple U ccimptitcra. used fof d^rcctlv 
inspecting or changmfi ihe conienu of main 
JiKnlCiry snd far apcrallng the eompulcr sE lhe 

jnov^ Td change die loodan of a msmoiy \f\l?ck- 

The Memofy Manager m»y mcis'e block* to 
consolldJiie memory space. 

movabNi A menioty bludf auribute, Indieitfng 
(hat tile Memory Manaj?er is free ro iiici^'e the 
block. Oppmsitc af ftxed. Only (hmIUihi- 
Jnde]Wndenl pragram segments may be in 
movable mccnory blacks. A block ■3 nude 
movable or fiticd [hrough Memnry Mmager calls 

natlTe ■ini>de:i The Id^bll Ppeiadng CDoEiguiaticin 
of itic 65t6l6 proccsinr. 

inrwUne mode; A fde-reatllna mode in whJch 
each dia^scter leid fiom liw Tile 15 compared to s 
9pe»fied chaiacier (c2l[cd the riBinline 
character); [f ihccc is a maTch, ihs .read a 
terminated PJe^wliilt mode is typically used to read 
crtilLviirhial lines nf ten, ■wiLh the twwllrte character 
dedned a$ a camige return. 



nlbbfci A unit fl Jnfcnnalioii {xntstsEdng of one- 
half cf a byte, or 4 blia. A nibble car ulie on any 
valtie between Q a,nd 15 (£0 antf SF hexaHJccimai). 

NIL! Pointing ta a value d! 0. A memojy handile it 
Nil. if ilM address it poicits to Js FDied wltJi zeros. 
Handles In- pui^d mi^mciry Ucieks. arr NIL 

iiid£ Ztca. 

null prcBx) A preHz gf aero length Cf^d ihe^dbrc 
nyHf.tiitertl), 

oblcct Dlci The output iicHn an assembler or 
cumpiler, and the Lnptit lo a linker. It contains 
madhJne-lanKuagi: instruoicins. Aisn called objea 
pmgram or ob]ec{ cndc Compaie source (lie. 

object, module formsh Tiic general format used 
in Apple lli:^^ objea flleji, library Tdca, and laid 
faes. 

OKF Ble: Any tile Jil object nnxlule Ibrmat. 

nji code .{!ee npcrodpn cnde. 

6]Mirad[lK syslcoi cbUi A request to execute a 
named rj^radi^ itysiem rune[li,]ni ai^io, d^f nanif 
□f die funoJon Ludf. opeh, gbt_file_ikfo, 
and OtllT arc PnsDOS l6 uperatinjj s>'»lcm CftllJ 

open] To aiioii' a<ce» 15 a Tile. A fUe mai* not be 
eead from or urfitien to until ii tf open. 

Dpemottr The pan of at! assembly UnguBfje 
■rUtru^-don dijt (oEl'ows the Opemlon code. The 
□pciand \a <jse^ lu a walue 9f an a^dt^Kf, or to 
cakulatc a value or an adtlrcss. 

njicnulng tnvfnMUDenL Tlie trvfrall hardnajx 
and .lotiVf'arc seiUng wLthln 'uhich a jvogram nuv. 
ALIO called execusiori tmtnnmmMJ 

aperalinf HynteniF A pfcgiaim thai ciigiriLTes Ihr 
a Lliuns uf Ihe varicua parts of the cdEnputer and its 
pierLpheral devices Sse aiff) dl^k. oji^ratinif 
syiiem. 
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npHstJnn ncode: The pun at i fna chine -titigua^ 
inslniction Ihat spcdflca ihc operation to be 
pcrformei OFtEJi cillgd op code 

pngti tU A partion nf memory 35*5 tqlci Jong and 
be^nnuig. it an a<fdi«si [liai l5 i.R ev«ii muliij^le i:ir 
2^6. McmcHy bl-i^KJu whiHC jtaitiiiH i.d(lrciie^ ai^ 
ii n e^r^ mulLJi^e cF 2^ are sajd lo Ik poj^ 
aitgned. (Z> An area, nf maLrv mcfnncy cofuaJnUig 
KfH E>r ^])hical IfifficAidlicin being dilipIayTd on 
ihr screen. 

paranteief: A vmluc pu«e<i no oi frnm ■ funcUon 

UT (llhcr inulin*_ 

pMtttWttr block: A S« qE^ ismigijuua ntCEEiaiy 
locjCians, kI jp by a taLliitg piogram lb psss 
paramewrj to Btid receive resulis Ffoni a,rt 
OpCiALing syslccn funClfoni ihat il '"jII^ Every call 
tD PiqDOS 16 ERLLit iinchidKz a. paintcc la i pipp^riy 
constru-CMd pirameier block. 

partial pailuuiiiei A poman of a paiboamE 

indudijia [he fUcnamc or rh-e dssin^il file buc 
SKduilirLg lijit vuLume direciary na,[nc Land 
pciS5[bly erne or cctoTC of the subdLccHsaflc; Ln the 
paihiia me), it Is the fuir of a piubnamr J^lbnnnB a 
prcfli — a prcfii and a partial pathfiam* itrgedirc 
i^orisihuie a Cull p^lhnuiic. A pulLal pithiba.[n£ 
docs [HJl begin with i -dtth because: li las no 
voluinc HJlrGrtory nicne. 

paich: To rcpk.4:c anc m man: bylica in [neniory 
« in a lUe uiih ijthet values. 'Clie aniiUess lo ^liich 
the pCKgi^m mu« ju mp ld excniic a subrautlrte ti 
paichsii into memfify ai lead time when a file la 
relo£ai«L 

palTinamri The cwnptele name b>- whj<* a file is 
SpefiElcd. [I [3 a seqiien>re of HlenainfB $«para[ed 
by ;]aihfi, stanlna with the fiiertiratf of L^ volume 
dicec[0i> 3"'^ fLiUan'iiiB the polh thmujih any 
sulxiiictiDrtc.'i iliai a pnogFJ m must folic™- ra \DCax 
\Vk file. A ccmplcce pathnimc always bcglxis wrftt i 
slash to, because voljcne tlireciory names always 
begin ^th a sla^ 



PMhaame sesx^cDit sej^nuiu jn a load lilc' ihai 
conl-aini the oosi-refcrencCa- t>e!nh*ti1. Inad files 
retefcnmd ^<j mimtacr (jn Ihc Jump Tabte 
sefcncnO aitd [htir paihriiLAkes OisKd Jn the lUe 
ijiccdiory). Th? Pathname segment is oe-atcd by 
the linka. 

Patluuine Tiritln A laUe cimsirjCKd in memciry 
ffom flU JndirldULl Paihiumc segmEiiis 
>cnc:ounI£Tf d dunrig loads, ll comaifu ihe aosa- 
rcEcrenccs bcEwecji load flLcs ccfcrenced l>y 
rturiJier (in iJie Jwmp Table) and fhelr pachJiamcs 
Clisled in the file (liiccloryj. 

pointer: An liecn &r inrornwtion ggmstfting at the 
mcmacy addicss o? sonne other item. FOr 
en^mple, she 65C81 S .jpdi J^jjiftcr ctuUains a 
paiELtcr lu (he lop of the sladi. 

pO^|J|>n-lii.depeadcnti Cp^C thai la wiiOcii 

3.pedfica3ty si) that iis. cKccutii^rL L; unafTi^CKd by lu^ 
]>nsliJon in mccnory. li can be moved wiihtTui 
iieeding lo be relocMei. 

prcBxt A poftion af a pnlinaiDt scaning wiih a 
vcjlume luiflic utcS ^iiddfig wJtli a A.ulxLlrcctaiy 
name. It is the pari nf a pathname befoit ihc 
poAJa] pailuume — ^ prefui md a pallia] 
pathnamE ti^({ethe( CQEii^tute a liill pathname. A 
prer^P always aans wiiti a sli^ CO b««u«e t^ 
vohimc diiccToLy name always slaiCs wilh a, i!uh 

prcflip omnben A code \4sed to represent a 

paiticuLar prefla;. Undei ProDOS 16, there are 
nlTK prcrix numhci's, cich >cnruL5ung of' a nLLmbcr 
tnr asterisk) foUowcd by a alajhi 0/, !/,._, B/,i 

PmDOS^ A J^amily of disk operating systems 
developed For the Apple 11 ramlly of computers- 
PfcDOJ stands foe /viVesritmainiit qptrtSWH? 
^ie?!^ and JnclLtdes boUi ProDOS € and 
PraDOE 16. 
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ProDOS B; A dUk aperSTlnU sySlemi dcvcloptd 

fur .standard Apple II compulcts. II runs on 
65CiZ^i?rLes micfoprocesjofs, It ilio run* on Uie 
Apple lies when the 65Cai5 pratcLsor ts in 6K)Z 
cmulatlctn D:tj>df. 

ProDOS 16i A di»k (^pcrailnK sysWoi 

devduped far 'fiiCSlA natWe mode operation nn 
ihc Af^le liGS, J1 L) funuljunally similar to 
PioiTMJS B but ftKwe pouwful. 

JtUlL Ta Trmovr the top eintry frtjm a gtwl^. 
mm-Jinfl lb*? sriek fKjLfVMf lo ^^e entry bcluw it 
SynonyiuDua u/ith ;x^. Compuc pusih. 

jHiTBccTa wmpomrUy ileallutite a raemnsry 
bloEk, The Mcntory Manager piicgcs a. block by 
setting its inaslcr pnLnlGC lo ^ilJ- (4). All llirdles V3 
(he painLET are sijlt inlidi SD (he block an. be 
re^or^smjoed qulddly. Q^mpaifc dlapiMc. 

purge lenh An attribute of a n»mory bbodc that 

jiet^ its piiOTily for puffing. A pitFj)P Icv^l or 
means that the blocJi Js unjxfgpjble. 

piJf][UltlC: A meffiiOry M&dc anributc, indicating, 
tJ'iat the Memtwy Minajsc may purge the block if li 
nce(£s iddicional HKmocy space. PuEj^eablc Iplock-S 
have dLETcjcnl pui^ I?vc^ ijt prii>ritltJa {icx 
pui^g; these l«i^ tvc (M by Memory Minagcr 

puab: la add an Usm to the (iSp Hjf a BlSClh 
Enaving the sack poinicr ID the nen entry above 
the top. Cumpare pmh. 

qamci A Lgi in wtiw:h entries are added, at nnc end 
and removed aE the other, causing enilles \0 be 
reinoMid In fl«l-ifl, fiiVE-bul (PIFO) oidcr. 
Compile suuk. 

quit return stacl<: A Jlick mairtainEtl in racmnry 
by PioDOS. 16. It contains a ILn «[ ptogniira! that 
have tcrmjnaseii tnjt are scheduled to rcmm when 
ihc prefiEnily execuiini; pro^ain \i finished 



i^Aiidmti-aecai Aaiob Set block cbrrCcc. 

reiCcrdU A componont of an load, segment. Ail 
DMF Sic segments lie campused uf recurds, 
siiiene of wWch are progfim. code and some of 
ijvhJd] j- nniain cross- icrerenc:^ or iclocatlan 
Infonnation. 

reoitnuii: Said of i routtne that is ^le lo accept 
9 CJl! while OTie .or rai>e prf^i^iniS eatls to tt arc 
pending, wthout invalidating ihr piievlou:^ fills. 
Undei certain ronditlotH, the Scbcdwlcr 
manages cuccution uf piD^mns that arc nut 
iGcnlmnt 

rEfercncrt Cn) The name af a segmem. Gr enuy 
point Ki i stgflieni; sisiie as jjwftofic re/sreftce. 
Cv) To refer to a symbolic referenoe or to use one 
in an utprcssiDn or as an adilress. 

Reload segmml: a iQld-Hle U^gmCMU Ihu ig 
a^way-.t Irradfd frnm \.he. ii\e at program startup, 
fegirdlesi-oriwtiatief the rest oEihepJoj^ram is 
loaded fnjui fJe or rcstaxled fiom rocmim^'. 
Rclrad segments contain InJrlali^tion 
inffifmaiiirii-i, «'i[h(]ut ■"hitli (■cruin type* of 
pmsrams wnultl nij( Jjc reslaiUble, 

KELOC recortt A pan of a rElocatlon dictiiinajy 
that conudns ('Clacdtlon bnlafnuiJQn. (ai local 
(■wLihlr-.icjjijKni] fefefenws. 

relotaiet To motlify a CLlc or segment at h^d time 

.w ihit it will oKeoire aypealy at its oufreni 
mtmOry lUirsIi'Un. Selocaliiin consists of 
pBlcfalnj the proper values onto addmss 
operandi. 11te loader [eloi:atcs load scgmtnu 
when i( loads Ihem into memory. &p aisa 
ftlocalabit 

rekxcBtabln Ciharactcnstic nf a Inad sci^jitcnt n* 
utE]» program code Lh^i jyidtides no aljsoluie 
addiEiscs, .and £d can be n:locaied at load time- A 
■cli^alable segment can be stalir, dynamLc, nr 
pnsl.tian indcpcntkni. Il onnsi.sij dL a cndc tmap 
fildloived by a rcllKAtibn lUctlonkry. Cnmpam 

BtKiOhTtfL 
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relacBtlon illctlariSlryi A ponjon of i load 
sc.gmcnL dl.l[ oSrilSLris E^Ujatinn Informalia-n 
amtamajy la modify the nncmOiy iitU^ pOTtfOn of 
tht senmenr. See nJacalE. 

restarli To leailivMc j. durnUIVl prugrxm in. iPt 
compucer's imemory. Tlie Sy'M«m Lender can 

if-SUrt doinTia.rLi. pragrsLms if aU iheir sULlr 
s^^pncnla are iLill irt mefrlOfr If IfiV C^rilical. part of 
i doovianl frfoftram hi? been jHiiBcd by Lbc 
McmoTT Manjgcr. ihii pfojjfaffl BiLUi be reloaded 
from disk Inatesd of rwtarW4- 

rcsmrtoblct Slid oi a pia^nm [h^L reinltJjlizes iE5 
variables iinij msifce* no assumpiiqiLs ibaut 
nudiljic sate eat± [tnvE Li nain: conccv]. Orilv 
if-S[afii>bte fKfCgnri'L'i un be cxciiuLcd from a. 
[lormBj^rL &LaLe in mem.t^ry. 

i¥suIl' An iiem of ii^roffluiiJon lecumcd \o a 
caHJng ptogrtw from i filncann. CcHnpair vdlui^. 

EtTL: Kclnjii Eruin subrjulJrie Long; i 6?CB16 
;tii&tlinbly-'l3ng,u9£e insmicLioiL. It is ua^d en 
mniuni^un with ^ J3L liutruciiion, 

HI'S! Reium from Siibroubnc; i 6502 irtd 6^1516 
;i$«emt)ly-liingu)ig« insirunicm. It 19 us^d in 
c^riLinctiDn f-'ith 1 J5H uisLrunJan. 

run-time library (lib A Lna.d nic CDnuinins 
program segmeiTiS — eidi -or wiiich cin be used In 
any number of pragraras — duat ihc SySiiem Loader 
Load'; dynMniolly when diey aie needed. 

iiBpllng flic: An Dr^anLnlional fcrm of 3 Pral50S 
16 sOndanJ flic A jjplinfl Rift Cfirsiau ofii jltib''^ 
bide> bhick ^d up lo 25b data bkKlu. 

[wiutsci TC «M£uw IntBmipteds'jftwjrs ihurla 
noL rcrnlinLDL If, for example, i.n inLcrmpL 
h*ndl-ei needs 10 make ProROS l&calls, li must dn 
50 ihrGugh tJic Scbedutcr bcouse Pn>DO& 1-6 is 
not reeninini. d^pplioarjoru need noi loe ctK 
Scheduler because FroIXlS 16 [2 not in bji 
inctnupced s[a[£ when ic pfoc£i<e^ afq>1ica [torts' 
syslcrn calls. 



aecmn A divismn uE a traiik on 1 tiisk. 'When ) 
djsli ]* Eciftnaned, its surface is divided Into tiacks 
and 5cclnr5. 

seedUng, me: An 'nTDanLzaiiCHUi rorm of a 
PioDOS lii aiandard flit, A sccdIitiE ftle canslsis 
cf 1 single daia t>ln<:k. 

segments A 'cnmpoticiii of an OMF Ble, 
ennsistirijj cf a header and a body, !n load files, 
each Stgmem Lncorixiraies one or more 
^ubrnuilncs. 

■Eomuii: kljid: A Dumefieal desianailon used tn 
rfijjlfy * segnt^nl Lm abfrcl module rerrflil It la 
tS]E value cf [he KIND Tteld Im Oie sciErnEnl'a 
lieid«r. 

BcqucadKl-BfCCH dCVJcCr ¥?J? cbxratTtEr 

devict. 

shadowing: The prfXESs wbeicby any diinges 
madf? to nnr part of ihc Apple IlG5 jnemnfy a;r 
aulonutlcally and siimtitanr^oiisty cxypicd into 
anothci pstt, 'OTirn *liadi>*ift8 is flti, informaHon 
wrirwfi tn biink ioa ar 301 is iuU>rni[ii:iU^ CQpLed 
lnlo cquivalenl JocniOfis in bsnk SEO nr tEl. 
Likewise, any dtingcs Lo hiok SEO Of SHI ire 
InimediaLciT wHecied in bank. SCO or Ml ■ 

■bell appUcadDiU A type prpK^iam dul Li 
liULirii^d fmm. a. cGutniJllag jHogfAin and 

run! under i\s i.'cimml. ShsLl app]ii:^tiDiu aic 

ProDQS le file Type SQl 

Boh swiicti: A tocatbon In, raemorv Uiai produces 
snme Fipccific cffcrt whenever lis ccEntenss are read 
or iwTrtien. 

wiurcr Hici An A5Clf file iW/WiSunjj of 
inJlruniQiu wrltlf n In a partlnilar lan^age, such 
as Fistil Of issenibly Isngusgc An jswmbfer or 
compiler canveils source fJe£ LilrlO ldf|Kt fOr^ 
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■pane fib A vadatlnn nf ibc at^ninrlrHii] 
CoiYTiS Ot PrODUS [« standard film. A spai^r file 
may be dtbcf a sap li n g fl]c or i trtt 111^ Whll 
mikfu it 3^nr \s [hr Fatl. ihal ib logical ejzd 
(de^rcd by ite EOFj ds. gmt^r ihan i[$ aaual sif 
an disk Tha occurt iwlien on* Or mtHC dlU 
biccka i:o[tlaIn nadiing bul zcm$, nia^ daU 
tiEngk.% *re «msldered 10 be pin of ihe file. bii[ 
ihtpf aie noi actu^tly allocated on dislc undl 
nonzcrn data ii wrlnai 10 rtiem, 

special memnry] On an Apple IEc;s, all ofaarUa 
iOa and ML, and all duplay memory in banka iEO 
Ind SEI. Sa cailed becau-'i*' u ■? tlT-e mejnofy 
directly acceded bt' iLUtdud Apple n programs 
running an the Apple DCS. 

itaek; A Hsi in "^jch cnirica aic added (pushed) 
and removed Cpullcd) at on« i^nij only (llie [op of 
the jUdO, cau^bcig them to be rcmm'cd in laM-in, 
flrat-oui <!JFO) order. Ttie lerm rtcuactuauisity 
K^ea m [be parllaiitB.r bUc]c pointed icv hy (he 
^5CBl6 5 stacfc register. Ccunparc queue. 

Siafk ttgistcc. A hacdn'ar^ reg/smr m (he ^5CSl6 
pr?>D5554>i' ltH.[ CO<^UiiU [Jk address □( the [tip of 
ihe prijcessdt's staii. 

•^tsndsnd Apple Hi Any cDcnputcr in die Apple It 

family encept the Apple IlG.5 ITut iridud(» chr 
Apple n,. die Afipte It iP'lus. \he Apple Lie, and the 
Af^e He 

■taDdard fflci One nfilie two prindjidi a<\es.orirs. 
c^VmDCJS 16. filet, jitandard File^ contain 
WhaKvtr data they wcjt rrrcaled tnii hoW, ihey have 
no predefined tntemal TormaL Ciimparc 
dlrecUMy file. 

start up: To gfS. [Bie sySJCm lunning. [t involves 
loading sysiem ioftwlrc frtjm dtli, and Ihen 
loadiitg and running an apiplieiiion. Akw caQed 

boa. 

stalk SegmeDL A sE^^^men) [hai Is lomfcd only at 

progmm boot Liriie, irul is nai unCnadcd during 
&veajiioci, Ccimpan: dyDBjnlc iseioieaL 



aonfc cype An attriboti; of a ProDOS 16 ^ that 
dcsdibcs the file": ar^anialiarai faim CsuCh iA 
diiea^y lilc. seedling f1}c, or sapling lllc) 

snbdlnrftDryt A PrdDOS 16 dircctary file ttui is 
fMt the volume tLtsOaty. 

fw^hcbcri A r:ontrnn.lA9 prgj^iacti thai lapidly 
tJSTufEJS cxecuiiun among several appli-Qiiaiu, 

sysieoi: A Hioordinaled rollccijon of iinerrtlaied 
a.nd InieranlnB parts organized ta perTDnn stnne 
fuoctiort Or adiieve scirfle purpose— for eKirapJe, 
a cnmpubrr ^iratcm compnsing, a praecssoi, 
keytxMrd, monitor, diik drive, and K>liwire. 

qiysteiii cbUi See opcrallafi wystcui tadL 

cyMem dkk: A disk thai cantaJns the c-pciating 
.■iV'sie-m and oiher 5V9l«<n sofwans rteedej (o njn 
apfdicaucins. 

SyHtrm Fadiire Manageri A firmvare prngram 
tlui piooeisses fatal errors by di^pr^ying a me^saage 
on the screen and Itaitinfl ejnecutlQii. 

■yRCDi nie: 5^sysi«ai piogmm. 

syBtnu (lie Icvdi A nutnber between iQO and sri? 

sssnclaied wlili each open PfoQOS \6 Rle. Kvety 
limi; i File is opened. Lhc cuiienl value n( the 
5y5Lem iilc level i? assigned to 11 If Ihe Fystcm flip 
level is ehangcd (by a .<;e:t_i.&vsl calD, all 
sijbsequenEtj" opened fJta. wU! have the new level 
assigned to ihem. By manipulating thf «ystEm [ili^ 
level, J cfinmoiiing progcam on eas-JIy dose fi 
flush rSa cpcTicd by lis sut^ragrams. 

System U>aden ITie progyam tliai rriaiiigea ihe 
I^Kiding and jr]t:H:aticMi of load segments 
(pcoarajTis) mtn the Apple Elcs im^f^ory. The 
Sy^iem Urj^der ivof t^ dosdy Tvith FroEXIS 16 and 
■he Memory Manager. 
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■ysKm pHiK'Biii' ^) A mdIWuc con:^>anen[ of a 

cumpulrr S>5[c:rn lha[ iuppoa* appUcaliaa 
pni^rains b)' miniginf; sysEtm rcsnuHrs xych is 

ntemcify ind I/O dei^ces, AJso failed, system 
wylujdre (2) Under PmlXJS 6, i sLirtd-alnWie artrt 
pTnentiJlly self-booting appUcaUor. A Pnjoos a 
syitcni puogcuxL i^ □( Hlc typi: fTT; if -il is ^IF- 

ffyittecn s^ifrwaret The cumpuncniB of a 
compuTct iiy.'iLi:n] dul suppnn. appllcMkiD 
programa b>' rranipng sysiem resounss }udi u 
■nemDry md L''0 devices. 

tool: Ki'ioolsei. 

t-ool set? A sfHi-u p cf relsied routines Cfeuilly ifi 
ilimwaiT^), availabtr lo applL[La[Ion5 and system 
soFwjfe, thai perform necessafy Cuncuoru or 
prt:rv{dc prGg[3.miiim^ canvcniencc. The MemDcy 
Ms.n>g«r, the Synem Loader, ind QuickDnw TI ire 
laal sets. 

xoofboK: \ fdlLe^en ef buili-iA reruiines on ihe 

Apple IIC5 ihix pragmns can call m pcifcrm 
many commoniy-nmdcd functinai. FurtnUms 
vr'ilhin ti^e toalbox arr gmuprd Jntu tnAl bfU. 

[I'lCk: One ut i Scries ai C'Dni:!:nLnc didcs an a 
dish. When 3. idiak es fcimiticd, lis suita.ce is 

[rcc nlc: Alt atgivisiiliansl Trmn af a Pi^DQS 1^ 
sUiuJsrd fl]e. A i!¥« file ciunststa of i s-iTigle 
o^asier :Liidcx block, up m 127 ladex blocksi 
and uj> 10 i)^,^]2 daia blodH. 

Typi^D, One of three fields in i^ie lJ*er n>, 1 

number ihal idcnlifics. cadi application. 

W^los^ I'O remOn^ i \tjid Kgrncnl Tiam mciiiarv. 
Tu unload a sc^iucnl, Ihc Sy^stcm Loafer diiicf rxii 
actually 'urIh^J" an\^hirLR, ii rtlEs (lie Mcmorv 
Uemsger w drfier purge <jr dtepuse of the 
meiTtDry h\ack in whLiiti the code ic^mcm rcsidi^. 
The ](jadcr ihen ttwpdiFies [he Memory Scgmem 
T;tbtB ii> reflect die (la cluL ihe segmcni ts na 
IcriBcc in nicmor^'. 



unpuffeable Ha^inBai purge knrel oTiffo. the 
Memory Majiagci je- noi penniCLed to jnir^? 

meiTiofy tJiadts who« puigC' level is zero. 

Lier nil An idenilflcaiJDii number |}|3! jp^tfLcs 
[ht Qwrttf of every memofy Wnck allocaied by the 
Memctfy Minigcr. Usee nj'a in; assigned by the 
User IP Mijwgef - 

I,bcr ID Maaugci^ A Locil set i^iil Is respor^Etile 

fm- a£&Lg!3i[>g User tP's tn Giray Hock of ntemcrfy 
allocated by ihc McixiDiy Majll^f^. 

vahieE An il«m of fcufocmslKjn passed fremii a 
calling routine ic a funcUan. Compare rcsuiU^ 

vi6ta AOolier: A di:«pLy device l^lal receives 
''itteo SigflaiS' iyv direct iC-nnncelinn only. 

Tcrf^^m A rvimbcr indicaEiilg ih^ fflnse dUtiOH 
or a plJliCulir piece of software Vrirajan niimbcrg 
(oi mo^ .'ii'Mieni ^pEtwajr (sui:iL ii FroDOS l6 and 
the System Lojder) ire iv^tilable ]iuw^i> fuiuikiii 

calK 

vohmHn An object ilut swres <Siii, Hv siputcc de 
dcsLlnulmi at infatmatton. A vclume tas i name 
and a vnlumc ducac^ry wilh ihe SIAK f\aitlC\ 
Information on a voJunw is stored in ftlc*. 
Vdlumcs typically Rsidc in devtCCS; i device SvCh 
IS I Floppy disk dilvc may contain one Oi any 
number sJ rOfurtiftS Cdisks). 

vfilupir blf map! A portituL of irvGiy PiaDOS 1^- 
farniaof d disk thai keeps tr^ck dT free i&k spaoe. 

voluiOF lUifitral blDfk (VCfi): A dau suuauie sa 

up in mejno'V tJV ProDOS ]6 to keep liadt dF all 
volume s.''{lci^c:es eomreeted ICh the fomputer. 

vohiiae dlrectixryi A IvolXiS t* directory file 
that is ttic principal diiicdoiy oi a vulujTie, It has 
[l>g sam« name M llic valumc, llic pathname of 
every fJc on the i^ume surts wUh ilw volume 
directory ctLRie. 

vohune nimiffi line ttame by which a purtiojJai 
volume Is identlE»ed li is the sa,me as the filffiuni^ 
of tthc voliiaic direeiorv fiCc. 
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WOtd: A group oTbila that is ticated as a cinlt Vat 

ihs! App{« Itos, a wwrd lal€ biLs Q byies^ lunfi. 

icro piijpn The (Irsi page U56 byicij of memory 
LTb a siajidarJ Apple n cotJipuici ilnr In ihe 
Apple ac& compulCr when running a standard 

Apple II pnrigrajnj. Bccaus*? the high-order byW 
□f any adfifesj m llli) put of memoty is aero, 
only a &ijiglc byle is nccJcd to specify a i^tQ-pfgs 
addiess. CoiTij:>ar^ dJr^^ pa^r 
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iniiitLuiKnn Fll-es 5i-54- SMulia 

-nieOO 
lnl[i*tiKail^ia KgmcnLi 224. 1S4 
iciltiillzlDg ^odl^te: riigiierB: 

Jnl[dll ichzd -all (Sydrm loacbi} 

iil-lii, 227, 2-ln 
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Modiry Meinory comnund 

fFiri-tr-i.»rl 2^; 

MfMibir pn^run bU. ISi, 293 

N 

named devlcH. Ji^drvterfjiJ 
luniM -Sw divlcefri. 

patfumnefsj; Ficnanws; 
WiliJnv<i) 
naiiv^ jBicdi! +, Sf. ^7. 100. Ssa 

alia pi ngmiictiing 
N'cwfbndlu ail fytrmaty Manager) 

79 
NIMLJMi ««|| rtii] tJ7-H0 
Bilttk. sue or 33 
K[L htaLBea. ii* mcTiflcy handles 
numben 

pjlhfume pnd.\x. ^HpalJlrumr 



obfErt rilM. .!iT nie<s> 

rih)sci ftrudidp ffwuioi TQ^ 7j|. gg^ 

197, 2110, i« 
ob)K! aegmipnia .'uw iffimmHB), 

duett poRE an(t udcfc 
OMP. See dbjcin module (isfmai 

niN_Lia-Ei=JHPro]>OSB) e& 

online devpcaa. Jiw dirvJCeCiJ 
□ PEN fill Jl, eu, 151-liZ, 2B7 

dt-icnption of I37-13B 
apfjjtins envJEoniUcni J, J2-72, 

IW. .Sen alio ifx^fflc ifyWc 
Dp^raiing ivaiErT>rs3, Appie Jl. 

compartson dl" 2S1-2BH. .Tm 

oifo specific cpgrating tysunn 

or ^Mi^fiC lefac 

calU, j^ivnetr e^lj* 

dcFsulr dL ^itailup 13 

Tilt cismpiUtiiliEy 2£l3-2H 

fMdlng DOS 3 3 =nd Appls ]] 

Pi^il dielu i»i 
nring cll^ 296-Zlf7 
hurmy d( ZBU3e2 
mpui/'outpiJ[ iSf, 
IdlcnupL suppon iss 
meintiry niinagsmcnc JB7 



aimlbncy «( 2B^28S 
nrBaniiaikm £J3Ih5> 

d^riniuan cs B3 

■Oftc K^rtn header Tidd IBS. 

$re oho hejidefS; it^gnvcDiCs;) 
ourpoi dcvlLcs, dernaJon of ^i 

Sw- also. d^vMMjftt) 
Crverlfc™, ata.:* Jw ttadi(i} 
uverliys 205 



pa^e, aOe or 3J, 29] Sre o^e 
mefflofy 

psramiELEr^J 1M-][H 

hlndts Sfl* parxciiicDei blorki 

Tiddi lie 

famtit lUi-ltH 

kngih nrf |Ki|m«iv intt handles 

ooder ol b>iH m a. fteld 1 ^J 

order on stacfc in 

p*fni|ii|blc ranae af viiluti 1[)5, 
107 

polnteii and i-a?-ici3, 1D6 

sii;iiing up EB niemory l(B-t04 

5.1,-ssein Loader Z13 

lypsi of IM, 213 
patatticta blocks LO, 31-82, M. 

lftJ-I04 
Fiscal opcrailng ■Byaiein 

fde j)n5fcm Zfrl 

nilnfcalb iS7 

huiriry of 2B3 

ln[crn]|a wpfKM ZBB 

I/O 2as 

n)emD.f>' mana^ifmiciiL B? 

Tiuding PaKAl disks 2B4 
Pascal suin^ 20 1 
piTdn. SwRAM, ^pjjto EESl 

palchlng IBS, 194 
paihnamGCsJ 7, 19^2], fij-Ss, 
J 17, 1?? 

a-Mlgnlng 31 

J'u[| 19, &3, 301 

number of diaiadcts in N 
panlal 19, 6i. fe. 168, i(H. ?i ] 
polislert ai, 52 
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pCEfnC^. 5w palhoairar piefllci 

mjiilKanmi^ oF I'J 
■wgnwnt l»1, 199, 200, 293 

putiuiii'n^ prtilxoa S, 14. 19-20, 
M-M, 131 
dppllnEMn (6-67, i6i, J0\ 
Iww ft, 57, iM 
aodt numbcn qF ill 

ElefiKdl 6^, 131 

ihtLi] ProDQS id va1iK4 6ti 

IntKxJwiwci. » 65-6? 

miiltipk 20 

null 20 

nunjKT dF chaftOfitl. [a lA 

nirnitwi* 66-67, ei, 131. 16S 

pu-FlLit fBThnJUEItg 1*? 
pcfdcFiried fi^ 

PioLX>& .£ ptdii arid patttnBnie 

cwiventwiw 6fl-S9 
sunpie* of M 

system, iipriilX)^ Sj 66. £9 

valine ^ 67^^ 
Paihnsinf Tattia IBS, 196, 
SKJ-iDl, 20fi, 22:;. iAi 
peripheral devicei. See devlce^s^ 
poijiKi<s) 26, id-iV. Sff^^ 
EOF. .Mafh, AicrncHY ttindl«& 
dErmiUiin or IQ^ 211 
FlcEda Sn ficl^ 

luulcr 3S 

or6tt tsl byiea 2M 

pararwier W^k 39-39, B3 

psiJiEumc &], A3 
pod mtbtiib^a 7 
pcnc 

communlEstKHi 9, 43 

disk sit, 'IS' 

■crial xfK 
PQ'JIt M, 59MS2. fd#ddSi3UU:T 

PtciDO? ft gUl r eall*. Bandad 

and enhanced 60 
PkiCOS 16 QlJIToU 6] 
pre^U, p^■l^l[UI^E. Ssr padinacnE 

prinfer^i % fl3 



print spoolcrB 8i 
ProDOS rai, M3. s«jjlia 

opcruJng iyaaentCs]; PiuDOS fl; 

PiaDDB 16 
PlcE30& tnwy flag. Sm buav flaff 
PHOL^ca rile SX S!. M-!e 
ProDOS 8 Kyiti, 5,9-13, 52, 

60-^1, 170. ^Ige alio ntiniiils. 

opcralmg ly-jIemCaJ 
app4K=LUi][U, iiicmciry banlu fcf 

33 

binarry file. 12, Z?*. zaj 

deeCTlptlon oF ^Jil, 4 

E nhi need QUIT calj £D-€] 

Flic syMflm Hi 

fiitnij caLlB 2aS 

gtahal fugK ID, 36, TS-flO 

ttia([li7 ^r iBi 

(nterrvp- njppon 288 

I/O 28} 

loaiUrig 1i% 

memoTV and 31, Bfi-B? 

on en Appie 11<« I'l. other 

Apple II compulcrs S 
palhnarnc of cunenL aj3f!i]E^ai30f1 

preFbi 6b-$ 

qui! type 60 

eUiK^ard QUFT «!] 6O-6I 

JV^I^M ClJli 9-11, IQi 

»y»iem dill" 56 

system flic 12, 58. IB2. 224 

afueiti pttta £6. SB 

«ySe(n p-Dgram 13, 5B, 182, 

2241 
unH {deulcE} nUinlwiC Bt 

PeoDOS S and PkjDOSW 9-15. 
Bfi-a9. 105-TI>S 

tall melhcidi unmfMfctl lOJ-lDti 

calti, convtrtlng 88 
compilaiicn/aioecnUy S9 
downwsKt coinp"'ihil»y 1 1 
Elimlnatad PruOOS 8 ayuccn cullt 

U 

tLudwdj'e iroiirigurfluoci 37 
Inierrwp handJErs, imidiFyinji hB 
iiieniur^' inan^gemoiH. 3fi 
new E^DOS 16 syi1«n qIIi IS 
rrruUbAg appllii^uians Bfi-ltiJ 



ae 

ufTward ctMnpaiilrillty lD-11 

"I'toLJUS 15 tHuy" error. J^ «ror« 

PccDClS Iti ud, 4-1!. ftwiin 

BUKDVnb; npaaiing B-f^ai^nf,^'^ rtr 

j!iA:l/)e topic 
adding raiilmU U 94-97 

dMcilptlonfli ii»i, 4-1? 

enrars 3O12-309. Siw >[il(i] errcTi 
»n«rrul dcvtres and 12^9 
Fined iDcalkmS 65 

Jilfiory of JSi 
Inuerfa™ !□ 89 

Bitroduiriian la 4-15 
[□FinCii'y i]^il xvlit, 31-40 

raBracHry map 35 

EkBW jr^M^dn calls 1! 
ProDOS S and S™ ProrVOS B 
and P^DOS IS 

xummaTV of CeaTiJiiu Ij-li 
fryetem itjIIs Seea^xxm calLt 
version nunnbci 17L 

ProDOg ].& ixaax]. Sw 
EjterclMr 

prognin biDk register ^k 

prcigmm counier rcglnier. ^ce 

Pro^mmEr'i WutksJujp Sec 
Apple llAl Programmer'a 
WOlLsbOp 

prcsT^mmini; nil. 74-91 Set aim 

applicaUun if^iilrcrncnu 74 
dinw page »nd iti,dt sneatioa 
page and slack 

pvpni-Jnwen xii 

level* in Apptt llai 5-7 
M^nKnicd X39C 
fi^igge.'ukKu For 74'^I 
Syuem Loader ZOi-ZlO 

TV-B-a 
pc^grims. See applteLlJcnbJi 
conlrrjlllng pfogrami; iiaiif 
prngranls 

pubtk^iUrKU ¥f«manualj 
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ptiige levelt 37. TT-7S. 185-186 

m 



CtriT oil (Pmons fl)^ aandud ind 

QUIT ciJI (PratXlS lej 15, 59-«I, 
&, 74, 77. H2, 307. 209-210, 

descT^uon o! 167-lTO 
return fiag- fsaninirtar 61,93 

tjMll -ranimMSd CtMercliert J*1 

qi^il flag 24;- 

D^tT pldixi^FB 62. !^ aiia 

guir aU 

quH remm flack ] &7. its ato 

quieting applitiHiMib. i:w 

^]pliotlantA> 
qwlt lypc C^iCiDOS aj S5 



RAM (Apple lie ar IlrJ J1 

Xam CApple nasi il. See aba 
racmocy 

fiSSci cnLry points in M 

1/D apace In 33 

pBlclica [D RQM-baMcl nooJ scU 

12-53- 
ispcdiJiizd ifbu. Jn 33 

JVM diaki 13 

SEftnjBL^C* call 1J, "H. JW 

dMCTlpiJiD laf 3S7-I5H 
RCfcQ nJI 34. iX <i, 85. U5 

i)«erlpllon of H I-H2 
Tcullns 

tfliectory Files »5-2M 

liisiM, DOS J.3 ami Pnesl 2M 

FiHs 24, Z7l 
KcacJl'luie call tUncrfiinsaws TmI 

SeO BO 
rcciwda 187, iSl, Z97 

[^IK7E.[»S££ JffT, 296 

nREl^-^ tST, 39"? 

ns 1B7. 2SI7 



ISlBflscc IS7. 18S. 1M-1P6, 

LC0IS3T 1*7, 2?7 
RELOc IJIT-lBa. 297 
SQPLH 187, JW 
rEffTCnct fiUiiiba t:-(^r_nLn) Siw 

file refewncs rikutibn 
rcglstia-s S^, J2'l 
icciimwlHor TT-lB. IM, SM, 

dila (Me* 1[>4 

dllttl 70, 77-7&, 104 

prKtHor =Ulu5 64. 105 
pc^gratn butk |Q4 

Jllogram ctnmt-cr ItKl 

>(vlc podiici 75, TT-t^ 3-04 

valun on cnuy inJ ritii from cill 

tU4. ^15 
X rc«lstD fri, 104, 208 
V rr^htcr «, 1(M, JM 
«l«dlng «pjilicaiio™ 5w 
appilcaiRnCi) 

rclaraUiblc ^lAcnLi 5ra 

.MKnifnldl' 
ieIdcuIchi dIClltMiuiu XST-IBB 

19S, mi 
FEL6C tccards iBT-lHfl, 157 
atn^KE cjiJ[ 277 
(rnarmng flte* SeB nirt'd 
rcqucBs Sitcalh; syBiem C3]|» 
tteatirt cRil [SystaiL IjhcIci) 201. 

deacr^len of 225-2JT 
redart-rrorn-itir^miify Hig IfiS 
rwtftnlHft a» appLldiiootisJ 
rcsuk, dBlTiililfln of [02^ Z\5 
(eruiTi n*BCDUirciH> 61.62. lis 
re*larii|j PicDOS S applJciujon* lor 
PraOOS 16 B6~a9. Sue nto 
?pp[lcsiUCKll>)| PrnDOS « ind 
PiaOG5 16; prDgfamrain^ 
HOM tAppIc lie (ir [[pj 341 
ROM (Apple [IG« J2. ^5-16- &* 
afrp tnC-JBlLlf^ 
rxpsinskin. card ii-A6 
Toulincs In ili, ^ 



CMl iEU j^, 5J-« 
mnlnes Sx alia Inicrrupt 
huidleixi llbntllH 
iddltij In ?n3DOS lE 93-?T 
Kppii Ugs Toolbai 9 

fJe-copying' M 

injtirupi. sreimeinupi lvndler& 

lll".y IV, TC*. ao 

j^mtf^ [jf, lypojLNptiJc 

canvention For lai 
prcBrani ujIceIjcvi CPflTTIJ SS 

Rjn-flmt llbrarfc*. i^llbmloi 



upirng fiUs 23, 3ii, ^6e, 

270^371 
Srhcdulcr 71, 9S 
MClor* 43, 251, 282, 384 

"HBdllng ni« 29. iS9. 270 

abwlutc iai-l§3, 1B6 
■llgnnMiiL fartor 299 
tunk-aligned 299 
d i red -page/ suLk 76, 79. |66. 

dynamic [BZ.1E3, 1B-5-1B6, 
I9i, 19fi, 2tM-205, 2M. 238, 

hodET rtdtb ie£. ?99 
inJliiliBUlOfl IBl, Z2'l, 227 
Jwn^!' TiUe. iM Sysietn Lotdtt 
K-Hc RHd 185. iS>, 2Z+, 39^ 
libr^rlra 70, 7^ 
\CAii 71. 76^ I8J, 3a5-lH6, 155, 

230 

load nuinfei^iii 3^9 
l«dlln^ 207 
main, 153 
Hcnwry SegmEni Tabic Set 

^yiem Loadet dai^ tatiliu; 
t>hjccl 7G 

pagf-aligned 299 
fMLhnamr mi, itKJ, aw, zqe 

piiSkkin-Uldcpcndpnl ISJ ifli 

IHg 
piwgcaWc 77-7a, 183, 185-166, 

207, 2J] 
Belaid 22S, 2^, 3?7 
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lun-tlnw llbnulM IttS 

iitaliif: 15, 77, 18i, 19i, 2D4,. 

334, 293 
LJiiloadliliB W? 
Ltnlodlicd 307 

se^ucnlial.iiCH* cle^iiTM- ■&* 

de^lwCfJ 
siirliJ potES, routlnei tnt xll 
5E7_^ar call 2i, « 
d^ncilpiltxi gr ]4{i 
aET_F;tF:_3WfOc«l.l 21, 86,134, 
3fiO, 2ii4. 277 

dmrriplibn q4 11»-]Z2 
StT_LE,UEL all 12, 2S, l« 

desalpt-lon of 151 
3ET_MRnf tail 2J, JSti 

deAcrtptkon ol L17 
3ST_THEFIM at) 20, ^, fiS.lfiJ 

{l6i«lplli?n *rf 151-15S 
ahadowing 34,61- fo* dito 
cnemory 

ihadow reglpier fri 

Shell CAP"*") 82, by, 206 

shell application 308 

*dl5 337, 332, 22^ Sfr alin 

eGntn:j11lng pra^rajiu 
ibEdling ditwn :l^«pplKailc<nCs) 
6!C0]'6 aiaonbly luigusge -^« 

as^mbly Canguai^ 
6502 micro F*OCiSMt 1, 9. 75 
lA-btl modE. JEi! native rcind? 
■luhea. prcfiie* and 19 
«1ot niuntiEr' 7, 4b £ra aiiia 

(^ipanslon di3l> 
ihb. .Snr elpuULOR SLeU 

iim»nPof5 15^4 

lal'l BWlLLtlCS, IciitMlLltig 6i, SI 

KiFliuarE*. 5te iib.a operallnft 

fffitEmfo); tlAM JUltli. PfMsir 
disks: syMem sol'twaK 

pjrTipatibilhy 4, 10-11 J™ aha 
PfoDOS 8 and PrnlXJS 1* 

Kf^uireiEij^nU XVllL-XK 

B^ndnd Apple IE 54 
SQS opcralmg jf^nn 

nie lyitcm 17a. 2B4. 287 

fJling C).1b 286 

hiilary or 2B2 



inierivpl support 2SB 

I/O HS 

mcmmy manigemcnE 287 
snuicE lUes 7S. 'm tifio file<s> 
spatK ni» .^BB fiJe(5) 
ppecial maiiiD»y. £™ memory 
S rcalsicrJuUcJt polracO- ■&» 

Tegl^frs. 
uacb<i) ScBalaa^tl«a pagE and 

(liiigrarrt (ormii (Sy^sirr Lz^dcr 

tslW 214 
hiirdwaiE 7S 
IflnaillCiM. WKivEctang. PtoDOS 8 Id 

PrnDOS It B3 
owrrflo*' 77 
pcJntcr 7S, 77-73. IM 
quil reium Slack l67 
mndtttdl Apptr I! Sbs Apple n, 

Bluiiiird ntca 26-2?. 270, Sr* 

rcrm?i and tifgantiatKin ciF 2l>7 

mding 172 
nsEkdatd 1/Q. S« InpJl/ouip"! 
Handaid QUH" call tPruOOS «) 

sartup -tiwappJicMlcinW, ijalcin 

sliimp 
siaiK prugtanu 77,201. Sw iiiro 

Syslmn l-mil*r 
iiailc seemenU. Si* segmcntW 
^al-ui reguur lO! ^nra^ 

devic*:j. Sm dfivlmKs) 
Warage lype llcliJ Z75 

aubdlrrrtniiEi 7. M. S3-S4. ^6 
Sr* dbo dircctorlici 
flic cniry a-nd 34 
fees 294 
headirre 2!»-761 

IlfanJT BO 

subroutines. .SccJuutitiei 
.^tir-^n refolds IB7, 298 
svhehcr* 2<J7, 33i 225 
i.ji*r?m call! m, 9-13. 94, 
5H-t77. iMdfrp^lla or 

call block 1i» 



converting ProDOS S [9 

PrcDOS 16 88 
^eflnillan af lOO 
iltwrlfRlnn latttlH 10^107 
dEh'LCE aUi- I51-H53 

cnvironniEm alls I&i-]71 

PjtHcuel diek B-nd 390 

rUc KOB5 i:JI= 1J6-152 

nip housckMpinj; laJIs l]£H3^ 

flUnjaUa. Sft- fpe accais call*: 

OJc hwiieltpejiinB. CB-Il* 
bilciTufi conirol caEli 171-177 
fntsmip" tundlEiM and 5^ 
pirameicf blocks ItXHDl Sw 

jib*paMmelEr(a> 
prpciiclng v'kb Eirctrii*' 270 
PKit>ase 11, 105 
Prrinos 16 CnewJ U 
fHJElser valuus on ctrtty anJ «k|[ 

fiom I^b 
sysj^in talS (cferenci 5B-1?7 
iVitffra dlBkn ^ix, ^2-5i. Ssi oil* 

disks; &vscm .nanup 
sppllcwkiii 53, :i4-« 

LTGaEipfrlff ^2—53 

lUndird Appk U S5-56. 69 
Syjru™ FaihtE Manager 49, Ti, 63 

systEm nip cPr^nos. s) 12, se, 

I8J, 22^ 

sv-swni ntc Irvrl 25. BU, H5, 

15I-I5£. 167 
bVa*m Lcadur bli-iS, 37, 53, Sd, 

(ia. 77-79. iai-^1. iWdfeJ 

THtMdS 

cans SscSyiWm Loajrr calls w 
coiwrilling prugiam tlewfin mfl 

2X7-20? ?™ ri&D conti'OtllnB 

piDjrajiiia 
dita lablea. iw Sv"*™ Laadci 

ddU W.hl« 
deactipiltiinjf ^O, 193-iej 
dDiminL iiai<? 62, 168. 185, 

u^. 25S, zi^e 

dyiBmlc aEgtucnls i«nd 3D4-2tft. 

enlTj; point J5, 30D 
terror! 310-311 
lunctiorli {M4egprc'«tl by ta,lkT) 
211} 
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Pathniimc raUc 159-iD! 


User ID 37. ill. 71, 77. 167-16H, 


■ InEcrface wlih Mcoiciy M^fi^.gn 


systiioi ptefii (ProDOS B 66. 


lefi, I9Z, I9t-I9;, 200. 2136, 


M 1IH-1B7 


■at-6? 


JOB. iW. 213. 216-2S7, 2J0, 


H InuocturZLiun lq 70, 1S2-I£9 


JeyiUsni proEratn OTqDOS »} 1 2. 


UJ. im. Hi. Sif .aJic 


H kaii4]\e Etrurtun^ 197 


W, JB2, 22'1 


MemiHy Muugcr, Ukj ID 


hMcUng rdbOUkac scgnunlt 


i^l^^ern ■iCK>UTi:ia, iiaaiBiiiR 


Muisgcr 


iFT-ies 


7J-B4 


AujiLD 30] 


meiritjiy map oT i^-JS 


it|fltrni aoRwire TU-TZ Sn- □&□ 


fanai JOD-Wl 


mcmmiy rctfULrcHwriu of ^rild 


sysum auk*. KiFlwarc 


Main ID Z03, 22J, 301 


panmncfs 21V7I1 


n^iarv banks ind JJ 


TypelD 71, ^23. 301 


pfDjpimmlng w|«h 203-210 


[JscrlDind 71 


Ukt BD MinagEF 71, 1^. 300-^1 


■rfptnKC Foi xlx 


sytitm startup 55-^U. 3in 


Utn ShMidnwn call CSynrm Ltadcri 


rcEocrsiion IR^^IB? 


iitmi innis lizHlofl sz, sfi-^ 


IB?. 2ljg. 225 


tesiai^n^ sjTicI FhuCIng ihmm 


detauli opcraimg ^■sieri 13 


iJEscTiplian af 2'14-i46 


fipplKiUJOna ^[B-21t) 


dcritip fFinb ^?-46 




nia-Clme tlbr^nes P-nd *D5-2Dfi 


■IrtTixtiJciion lo 55-55 




**pnrni liiiidLng, u^cr ccnuml or 


LoiiJcr iniLialiiulIm 215 


V 


20ri^2Q7. .&ir aira .scgmentC*) 


pKigram scJeokm 53-5") 


vilu*. dpfiniiltai cj lOZ, 213 


Kaiic programs ind aM 


fi^bCxJLin^ i1 ? 


vanaU'U, glGibiJ 5:«i>gtalMl 


IcchnlcsJ ndaia Z9S-W 1 




'■'arlubks 


irnnlnoJcB)' IBJ-ltH 




vcn. Sm >'(j[um« controJ blodu 


i' version nuitiber 319-;i9' 


t 


vcclon Jic tniermp i<ecDgr ^3Mt 


£yi«aii LDada mils ?l[^-Z^a. ii'p 


laMcB. JhWlniemjpl urt-oi lUble; 


vnac^ spat?- values 54 


iO'cCI I/>Cf^tf Cli'I'l 


Syscem l«4dn dabi tablei 


vrmiori nuiEibers 


till blrt^t 2!3 


■jmc .f£« rrcuion d^r and ilmE, 


niB syitcm «s, aso, ifij, 305 


calEgorb» i>F ZIO 


ttUjdiTicaLiQn dik- and ilmt^ 


ntij«1 nHxtuk f-annii IJO 


U dcfcfipuon fsnnil SU 


[taaltnw, iw Apple lies Toll trai 


PraUas 16 171 


liQ«> olii M'B rrudE 215 


tOQl oJla 6-7 Stf^AifCSJScM^i'c 


Systrm Laidcr 2[».7ig 


p^nuEiCKi typea JJS-JM. iBe 


fonf 


video- miliary Scff mf mo-ry 


iiA^ itipannry Mo^ke; 


looli xls. 7fU7J, 193- J«p EiiD 


vcliam^) 7-a . Sl¥ rt&O 1|IKB> 


par^[T>e(etts) 


KAM.Iuud iTOiSi KUM-based 


boot Si 


: ^yitcm Loider dsia LiUci 


inofs or ipm-^ tool 


directutJea 7. IB, »* 


, 19J-M2 


T'iCL.SETUI' Hk 5i, ifi 


<ibreni5ry header* Z5iS-25'B 


JumpTubJp 1«9. ]?J-IOS, an? 


iraclcs iflj, 2J4. 2B2. 2W 


formxixing 254 


p Jump Tihtc Rircclory 


innirertiii)! 


nwiici 7, M, IB, 43. 117 


153-1^4. 196 


dia iQ ^nd Troni Rlu £1 


orginiiaiiiwi *rf infwnwilo] on 


dJignun of ISS 


sparse fdei }0 


i5i-Ji? 


direclory -eriiry 191 


tfee nia 28, 29, 1!62, ZT1.I7! 


ItJiCE iOf 1-4 


modTidinn Bi load ciiiw 1^ 


pcHwIng 26J-2S9 


injlumc biL map ;S4, MS 


Jump Table Load caJI 


Typctn. is Uwr ED 


VOIQME call 11, tA. 80 


19S-IM, 2]3, Z'l7-5'ie 




dCKripCxin at liS-lKI 


Judip'Ti^lc-LaaxJcd lliLg 10], 




vc4uiiie conLrol btodt^ 17 


25i 


U 




Ma«l=nl cnlry tH-l?5. ir 


undklined InCr^nupb. Sw 




K. ipgmints 201, 2?B, ]W-!>5j. 


iatemipitt> 


W 


jer r]i!!i] ti^ijnif nLOO 


UnrDi»)i3,! <J 


Wixd. filE fif 3 J, 1 02 Sg* aico 


use ducing exeoitlon 1?6-IS^ 


Unload Sesm™! B» Number cill 


InngBiJJKl 


Mm-ft Lka 2U1-2D2 


ftyjlcm IjnvigO MiT, 137 


iffP:TE_BLKK ESlI Al, 41. IW, 


McJdiui) Di^|<<iliclli TbUi: 


ftpwrlpElfuv aF 3^:1 qji^ 


aim 


133-lW. iiW dljo KgmrnrW 


uppiJihair IcUten IS 


iJcHilpllcn qF IJi? 


^^^^^^^^^^^^^^^^^^^^^^^^^^^H 



HRITr i^ll 2*, +2, <4. B5,2&1. 177 

dtiftlpilcm d HS'lW 
wiltc-cnabie bll ti7 
v-iltlng 

ipplioillniu H9 

lilci 24 



)(-¥-2 

N re^ICJ M. 104, 2DH 

VregWer ^. 104, ZM 
P*6* 



33« 



rvij&x 



ProDOS UColU 



Call HIcKk; 

JSi PSODOS 

DC 12 'CALLNLM^ 

DC M '^-AKMBLOi^K- 

nCS EHHOH 



PHODOS tfiEiy poiffl 
' JC] DOAfl 

£iirA m tnar dluifton be a 

f^rammr block etu^ram 
rvfjTeifTit) WW tyfe 



Ml 

CREATE 


painlDJ 

value 
PQinrer 

VOJIjiD 

vBue 
VDiue 

vsiue 

value 
vMbe 


S02 
DESTHDV 


painhei 
polM»f 

■HIi/1 

reiun 

re!uH 

■BlUlt 
TDELfl 

rOIUI 


(04 
CIUNim.PATH 


panln.- 
pciinli- 

DOlntfli 
palril«i 1 

FBIlJI 1 

rBiL«i 


Q 
1 

3 


, 


pa-hnom* 


1 

2 


■ 


paltinama 




r 

7 

IS 


1- 


polrf^mo 


< 

s 


- 


m;<;B'tt 






.FlL&_LiiJPO 


l- 


nBwj^nlhnama 




■ 


"iiB lype 




7 


- 




; 


ou'.lfDfl 




TWE 


c 


- 


ilornga.l'yp* 




E 
r 


- 


ceal&.dQ'a 


lU 
11 


- 


creaiejime 


SE 


15 


fll^JNFO 


G£T. 


$08 
vou 


1 
i 


- 


porhnrmo 


I 

i 

1. 
b 
6 

t 

K 

a 
z 

E 
F 

ra 
ii 
>j 
I] 

IS 

!.» 

r? 
ifl 
1? 




i 
pomnan*' - 




1 

3 

6 
t. 
) 
t. 
1 
A 

C 
D 
E 

F 

10 
II 


; 


«J»v_name 


4 


- 


accai! 




aecAii 


_ 


voLnarrrH 


7 


- 


riie_fre>« 




rile.lypa 


B 


- 


Cun.lypB- 




□uy.i'VPO 


' 


'PfOLDIOCH 




- 


(nufneid) 




iioroae.riiD* 


■ 


rpfla.o«<:ii» 


F 


- 


Ciporg.ODie 


- 


trsals.datB 


11 


1- 


CTDate^himB 


- 


qnkal'V.Mmv ■» 


■ 


Mv !lH.ltl 


13 


- 


mod.dalB 


- 


■nod.tkjffl 








IS 


- 


mod.imii* 


- 


mDd_la«i« 










■ 


Qiaekt.Ldaa 



S09 
SET.PHEFJK 






SOA 


vriiiiT 
pop.ni-itr 

vlull 
■r^luB- 

vdiua 

^ j>ue 

uglgo 
roiull 


SOQ 







piB*i"_nijfri 


- 


vaue 
painiei 


c 
1 

z 

3 

5 


piefiK. nuiii 


□ 
1 

! 
3 


parhnoine 


- 


paniB 


2 

3 


pi&dl 


- 


prB4|^ 


4 
S 


$11 

ufad 






$10 
OPEN 






lULWLINE 


1] 
1 


lef.num 


- 


IMUll 

ponisr 
roiuir 


□ 
1 
2 
3 

a 
5 


ftLni,*! 


3 

2 

iL 

E 

b 
7 
B 

A 

B 
C 
D 


ie'_ni,.m 


" 


ifcruB 


2 


c>a^hnCTT«> 


■ 


Bnobia.maii 


d4la. tiuHar 


- 




5 


iflvriine.cnw 


EiOJnlAf 


7 


o.OijKei 


■ 






reqiieil.cQunl 


- 


uOlie 


SJ3 
WWTE 








- 

'r«iirw_cci>jrir 


- 


IfiSlA 


114 


FLUSH 








1 


iBf.rium 


- 


pointier 
vtult 


1 


re"! nu"! ■ 


Q 

1 


rBLnum 


- 


ucIlm 


2 
3 
4 
5. 


Qala.tujfUffr 


-I 














7 
D 


roqUDII'.CO'jnl 


_ 








A 
B 

C 
D 


lianaTflr cogrrl 


^ 




SET^MAHK 






*17 
GET_UiUU[ 


51B 
SET.EOF 






^ - liir.num 


- 


waija 

VDIj9 



1 
i 

z 

5 


ifi'l Hum 




i 

1 

A 

5 


*ier_riuiTi 


- 


vanjf 


I- 

^ - emftlun 

5 ' 


. 


coilltin 


•Of 


■ 


ui?Lja 



I -| potntar 



- oamar 



jnl - nauit 



v<Aia 



VOlUB 

vfllue 



Si 9 
CET.EOF 



SIA 

SET_LEVEL 



BOf 



GEt_i>ev_m:[M 



S2l 

GET LAST DEV 



!E 



WMTF,_BLOCK 



S24 
FORMAT 



i2b 
GET.BOOr VOL 



$29 
(JUTT 





1 

z 



dala.bulTei 



■ pt^nlar 



poltinama 



rupi 



S3I 

AILOC LNTERRl.'PT 



■ 


oev.nufTv 


- 


iicikje 




I 
7 

i 
4 
b 

a 

7 

n 


r1nt..na'ns 


- 


pcw-.te' 


. 




^ 


^ 


_ 




■ 


DQ'Q.Du'rer 


- 


pmnFBi 


"■ vol noma 


- 


parr,1ei 


■ 




- 




■ 


* 




t 




_ 


1- 


- 




■ 


nioc" iiim 


- 


-OlOB 


rii«_ivi.iQ 


- 


vaue 


' 




~ 




g 


" 


~ 





- pralnlCfi 



«32 
OeallOC.inti.rkupt 



rn^num 



- poinlej 



GET.LEVEL 



?E 



S22 

READ.flLQCX 



D 
1 


■ 


LJev,num 


- 


3 


. 




_ 


■ 


dalo-.DPj'fei 


- 


b 


■ 




- 


6 

r 
a 

9 


. 




_ 


' 


blac^.num 


■ 



Si7 



dato Ool'ei - aoni-t 



S2A 

Girr.veftsiow 



Fields 





Access Brf<^ 


b 


7 


Ala 


4J3|: 


1 


a 


kWA 


'^ 


™U 


■n«r-«d 


n 


3 



Segmcnl KDtD 












l^r» 1 


»F>rS 




15 14 


n 


:2',1IIID|5 |S |7|a| 5 


i\i-\2\ 1 


IQ 


in 


- 


n 


3MJ*2| n-| [■BMr.™j> 


IvB» 



D - [tesimy -enable bli 
KN ■ cerumc-cnable- bit 
B - h^irku p-nixLlcd bdL 

R >■ fcad-cnatdc bii 



Crca(jf)ii/MiHlincA[ion tiaie 



SD 
Pr 
PI 



B[7|a;5 | iilj3i; 



Type 

300 
Ml 

su 



]: scgmcrU Lt ptiMIt 
] : jcgrncn! i; pasirinrt- 

st^j^ienl may nc< be in spmiil 

Desorlptlan 

toiJc S(.'jiinC:ill 
diu icgn^rnl 

Juntp lahlc scftmeni 
PiLhname wgnwni 
lib-rary d-Ldiortaij' scgmcnl 
inlliiLidrJOil i^gnwnl 
direi:1-pajic/ilack scgciH^nC 



L'»er ID Word 






BvWI 




Pv<ail 




A* 


15 W|l3|l-3 


ll|lClv B 


7 1 


s |5M UUI 


|Q 


bVW 


Ii(pri O 


Auk 10 


Mon ly 



i:c>nlrd.ling: prOgwm 
\'ttiOO?i B and PfdDOS id 

tool 5Cfl 

lun-llmc ELbn4iy 

fi rmwattL'syslcm (uilrtio-rt 

fumlcEiiitrii) 
f iTTypelD - ifii. these values of AuxlD ire 
resecvedi 

Misceilartcous loolset file 
Scnp Hauler (ILc 





Erior Codes, Files, and Recofds 




PtqDOS 16 Error C<kIcs 


System Luadcr Hn^or Codo 




Soi^atai 




S]I01 NrX^ndl 




Sf)I 


Invalid can num'tet 
FruDOS u busy 


SlIDZ IncoiDpiUlile OMF wMcin 

SniM FJbe b 1X4 1 bud TiEc | 
SllD^ Loaftristusy ■ 
SIW? H!e vcrlion err™- ; 
Si 108 User [Dwrw ; 
S11D9 SegNum cm. □r .azcjucruE' 




SLD 


Dcvifrt nor found. 




= 1] 

^2R 


Invilid dcvLo: icqui^st 
Intcfnipi vi^doriable Tull 
[/C> crrar 
Nij licvitt" Ctjnnfiacd. 




^iB 


W nic -pitj 1 ccl cd 


SnOA UlcBal loiKl fecoid TouJid ! 




SZD 


S110B Load SFgmrnlla foiFign J 




^^K 


Diak swilLhcd 






S25 


Dcvioc not (HI Ilhc: 






^50 . i3F 


Devlce-i-fScfifif^ errcrs 


ProIJOS 16 Filcnamcis 




5 40 


Invilid pa[]~u~Lijnc/dcvu:c nsjnc 








s>inux 


A rdcjiiruc nuy contain anv caihtilnjilan tif 




S12 
J^3 


KmisblrTull 

Ifi^'jLd flic fcfcrgnce nuint^j 


« capital Ifttcm \ [hrou^ '£■ 




S':4 


Path n4^ rnufid 


• numbers thrwjgh 3 




JflS 


Volume not Jound 


■ ptniods [.3 






Hlc not rmtnij 


It nnul begin witti 1 IcUci. 




S4S 


Volume ]\jI1 


It nMr be up Id 15 charadcra lim^ 1^4 




S49 


VolumE: djrcctacy fuU 




$4A 


Version, ctmi CintDinpaiJbJe file 


A \tolumc namii ^MavJi the name nAcs. buL aba 
must hai'fi » pi*«idiins jJish tO. ^ 




SIB 


fUrm^LJ 

Unsuppornsd for liKn^rreci) siurigc 






lypc 


H 




SID 


Hnd-nE-IilE f n-Mniniered (m« wF dau) 
Pnsilion ayA af range 


ProDOS 16 Psihnaffics ii 




SilE 


Access ruX kUDWc^ 






Sso 


Filelj cpcr 


A jMlhruiTK: Ls u sec^uEnoe al tilenamc^ 




551 


t>Lrcfl*Hy siructiirc djmagcd 


M:puaicd by nlL^lu» 




3^Z 


Unaippoctcd voOujnc type 






S!3 


Ptrnneier oui or tuige 


A full pat^lname twjjinj wUl 1 Sbstl CatwJ 3 




^^■1 


Out at mciiMMy 


vflJunu rtaiflie) 




i5! 


VC3 latlle full 






S6.7 


Uuptialc vdlLimc 


A panial plthrdttt: begins with a nicnamc □[ 






>J« * Woch CfcvltC 
Invalid tvri 


A picfix number 




^5C 


Bkiek riu.mlxir oiH ii^f range 
]J]egil pjlKnjrnf: change 
N'M an exscLiUihli! Fll? 


A FllJ or partial paEhnanv may be up 4o 64 




\sn 


OpcraEing sysLrmi'l'JlE sysEcrn not 






t^E 


dnnoE dt^llcH!3ic I'OAM 


l»roDOS 16 Preflxes 




ssr 


'RtiiAm ^df (n'Cfflow 






5(iO 


Dau uni'i'aiLa.blc 


C/ dcfaull p<«nit 




Si)! 




1/ appllicaticin subdimrlnry prcllx 




L'rtclaimed Jnieirupi 


2/ systi^m iibrarv prefn 

5/' 7/ fuserassEgiwtf) 




:iOS 


H:B uru&lbbf 


■ / bjDol pccfia 




5:1c 


Ellcick zFFo iHoalrd iDrjplEy 






;siin 


[ncctnipi. ttcwried while l^O 


An Ipplli^ljon. can tJiangc ihc pathiumc 






iKadowing off 


ijjigned to anj' pr-efk* (except •/> 




>]\ 


WI"□:^a OS versJDEi 







FroDOS File Types 



Mf 



JtlhO 



eftic 



IT 



Co4t 



301 


BAD 


JOJt 


PCD 


ioi t 


PTX 


i04 


TXT 


S05t 


PDA 


SM 


&IN 


JU7t 


FNT 


soft 


ror 


JQ&J 


BA3 


iOAt 


DAJ 


SOB t 


WTF 


wet 


SOS 


SDD-iOE t 


SDF 


DIN 


Slot 


RFD 


snt 


HP] 


Sl2t 




Slit 




jut 




SIS + 




Jl6-Sl8t 


J19 


ADB 


JlA 


ATFP 


SIB 


ASP 


ilC-SA? 


SBD 


SRC 


3BI 


em 


SB 2 


LEb 


4B3 


SI6 


$El'4 


HTL 


JB5 


EXE 



JB6 

S&7 

$B9 
ADA 

9BB-IBE 
IBF 

Sep pas 



ipj 



CMD 



SPt-SFB 

SPA INT 

!FB IVR 

Jrc HAS 



[)«crlp|Joa 
LTiaiCBorizeii Tite 

tS05/PraDOS5 

B*d bioci( Pte 

I'aHal code fUe 

Pascal tcrt file 

ASCiJ: ffiixi file <30S/ProDOS] 

Paso] dali fJc 

Gen, blrvary Tite 

4,50S/PkiD05 b) 

Fonc Rle 

CraphJc3 screen Hie 

bUiirtCiS ViA5K- proflram lite 

BLiSLneu MS]C liju EUg 

WOfd l'fOCCM« file 

SOS system file 

<JIOS ^vrved) 

Djrecioiy Ttlc (S03/ProDOS) 

Kl-S daia Hie 

UPS fftifcn (ilf 

ApptcFlle discard file 

Appicirile rnoiiet IJIc 

ApplcFilc rrport fnrmal Tile 

Soeen Ubraiy Tile 

ApplcWtirk* r>*« Bmc life 
ApplcWorta Wwd Pirm fiJr 
Appk*'cirSa SpfMdihMt Hk 
f reserved! 
Al^' *(»jf« Kle 
APW objca fJe 
APW Lbraiy lUc 

f?crM>s ifi jppiiaiiwi pioa. 

file 

APW mn-terw Uhrary fdc 

PraDOS 16 fhell aprpl^tadon 

Dlr 

ProDOS ^€ penTMrwra ilnJi, 

iBe 

FmOoS l4 lemponry inii. TiU; 

LScwdcsk iccEsoty 

Cl-uik Jok acOTsJOfy 

Tool Ad file 

(i«erved rof PtoDQS 16 loid 

Hca} 

Pr«>noS \i document hie 

CreBeivmdJ 

Pucdi arra nn s TumUancd 

di^ 

ProDOS fi CI added foinnund 

Pn>IX>S a tiser dcAncd Tbiea l-S 

tl'mDnS B rc5»^fv&dj 
[nicger IJASlC program flic 
[ntcux EASiC viijabk: El1c 
Appfesofc pfosufii nie 



ProIM>S FSIc Types [conUnucdj 

Type Code DffscrliHlDin 

SFD V'AR Apptc&art variables file 

3FK Bl-]. BrlWiisbk onk r.lc CKI^ASM) 

SFF SYS PtoDOS S iyslciiL pcoaram rdc 



Storage Type 

S] inactive file entry 

31 wcdlinB file cntty fEOF <- 256 bytes) 

ii ISplli^ niE trttry 

G5i < EOF -e- 12EK bylcs) 

53 tree file entry 
(laSK'^EOF'; I'fiMbyies) 

54 Pascal cpcnCing system aira otl 
ii ^njniUoned rfL* 

JhD Eubdicectory fi]e cniry 

iE swlwlji^ctun' he^ife' 

jF voluinc dinrctaiy header 



File System ID 



I 



2; 

I 

I 

i 



D 


■([c served) 


I 


ProDQS/SQS 


2 


DOS 3.5 


3 


DOS 5 2, 5 t 


4 


AppOe 13 Pascal 


5 


^faci^tclsh 


i 


Macintosh (HPSJ 


7 


LISA 


3 


Apple CP/M 


?'255 


trtsefW'd) 



Load Ftlc Rc-conls 



Code 


Nbiuc 


SE2 


P£LOC 


SEJ 


XWTCBSEG 


SFl 


SS 


SF2 


1/;CNST 


5r5 


cREl>3C: 


3F6 


cJMTEMSG 


$l-7 


SUPER 


SM 


INS 




D[3crlp«ldit 

Imrasegment reEocaiion 

iccDrd 

intejscgtneni rcltxaiJon 

recntd 

zero-fill rccont 

lpng.-eorisUn| record 

(includes aU ccxle and data} 

ctimpreai»;il tnErasegnLt;ni 

rr]ncaLan lecord 

oompnjMtpd IriteiwsinKjni 

rrJocaLon jeDard 

lupci-comprc^cc! 

rdrcalion rpqord 

end of the ScgmCriC 



Syst^fD Loader Calls 

1 Push icsuh space (u showTL 

it LhcaAck 

- Fu^ inpui jnnineuTS (in 
□iilcr &nawn on Silc:!: 

} Eipcutc cad block; 

LDX 'Ill*Punc:^Jmll 

FunCiNwm ■ numbei of 
rujii:llp[i bcJjijj i:4.1]cd 

UiBpau^^ ' Taal dJspiLdnci 

CinidrftM - sti ocoo;) 

■1 On 0!tmpl!;rliifi, if >uLtA i^iliL 
be in urder ^hdwri un Ji'jcuJi 

Each minor division |ri audc^lr 



S09 

tnJtial Load 

SuiCit Before Call 



CrH^ scQoei 



(.rsjijf JQiXSt 



(renjtf apece) 



ttrzutt .-L-iccri 



p^xTd ftp i-arnfl 



ijgci'o' fTv^iiiv> .Vig 



Slack Afi^r rati 



prey Win ccfitBfTft 



df poBefztrxli adSr 



ifcniJnff ix^ciiHd - 



Lte^ 



-5F 



504 

Loader Version 

.tuicft Be/ofc Can- 
sue* ^jfler coil- 

I prqviiii-J i^Cinlianl 



U-sp 



Restart 



f^jljlf iptitoj 



f'sim' rpLJcei 



{rar-f ipwal 






Stack After call 



i:tr poja/JJcJi::*' ajb . 



'If 






■ir 



$06 

Lo;icler i^tatua 

Slack Be/on f'oiZ 






Slack AjisT Call 



L, 



Bal'j 



I. 



SOU 

Load Sc^gmcni By No. 



rwiu'' iWK'OJ 






qoJ.!gg'"Of f no 



-Jf 



Siack Ajl^ coil 



pq/ntfnr 



<-SP 



nMHf 



^mck Ajt 



L. 



By NO, 



JUctJ 



_ia 



Unload Seg. By No. 



to3.j-f.i; ntynpgf 



. ^Q^'.^S^S^'^' ^Q 






Ctl Load Segment Info 

SiOik Be/DK Cali^ 



fjMflJ 



fcqrf jggrnenf ftp 

■ -■-.[;■. - - ' 



Ql3l*eiJ Of 



-SP 



Aac^ Afler Call 
.1 p-evKiut clJ"l^anll, 



512 

User Shutdown 

Situt Bc/ot CeH-- 

_e^8VOLil_C5E!t3lSL 



fmuit rpocgJ 



aiitWJO 



lx>ad *ieg. By Name 

Slack Be/an Ca& 



(ITJU* jtoew 



Ji^njH Hjgi;BJ 









^Jal^-fc^^y^el^*no^^p 



4-H 






jouci- M.-iji '-t"'' nu 



jeomgn 



■SP 



$10 

Gel L'ser ID 

Si(D;k Refers Caii: 






♦-SP 



Siatk A/ler CsU.- 






SOE 

Linload ScjKiQcnt 

Jfaci Be/a'n Call 



■ua/r j<Mcgj 



fi-Ha.ttjpgcfl) 



<'jfH^'l !C>-1C3J 



- adarea rn legri'-ffrnl - 



I 
{ 



■H-iF 






ipi^UijOmPTpJ no. 



»11 

GetPaihtume 



- [ipiuti ipoc«? 



iJjtfiiP 



Sac* x^w CflU- 






poThnpTw 



-«P 



-Sf 



jJOCfe After call 



t, 



e Appk CnmfHUef, Ifi-- 19^"' 
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ThL'i man ml giws an i ivtrviw rif ttv i iixi^aiiri; WTflem and j deiiiW 
JiiiiinicriDlJmii'f iis pnw"-im[iiinj( Sr.miat, iipitulizLTj Irj^iics intluik.- 

* iwiithiKsiiapiiilv 'urauri^ jppti;:a£kin.'itn'[iuikin|; thtcri dtanmitand nriCiniiijj flicm. 

* Wriiiftf]nnB]l.l[iispr?ip:;LniSMJi-fi;L';slittli;uiilNft1[dit'r. 

* Wiling intifmifi handl«Ti. 

* Si.:rkiii((TsiriimMltiplL'|;tilhn;irncpn!fixcs. 

* &Tnvertin^ap(il«miMwhi'i?i(W3l¥nrXTS^Ki'wnrkwihPri'iD0516 
tltAffjk Ha ftnflQS KiRe^rftvs L^ fMyariiiM] iniH riiir part.- 

' Rirt I^X*iS htm huDOS HJ owd&and UIpt]in^^JnTll.■ it iiiffi;rs. 6iiii lU 

prEdrca'ior, PmrXlS A 
- P¥[D.di?<JlLK:s;Jll^j4XlM6a)fTinLxniislNysianL'd^^ 

* F^ ID diamMfrciLhb Sysar U ladei^^ EJexlhfe [in ^jnimm^ [unl that hsiky 
tnli;udi,anJ manipublt'j prrr^rnm bq^crHs dI cncmury 

* fart [V"(vmsta.mi^:ifrpcndi>;tS J ijliJWJnv Jii J n Vvk\- The i(:jKnclbffis itet'rihe 
[hf I^DOti l&filcstriiMmjit:. oudinfihi.'hBtiin'iifAppk: II (^T-jiii>rsi,acnB, 

Codes, 2nd pmvide^iilditxiru] Sj.'iiem LaoJerHeduiicil inkimuiiLin. 

A qukk-ffifrrtnO-'fanJ h njnd mm ik' m;tnin"i£ labtibi.-^ Pnir.'CK In iiral 5vsti;m 
Luotlo' rails, omni, ind diim i^injoun^. The E.i£n:bi>fr dKk in die hoik pitdoa alkTws 

TfhiiHi liY ii<^mhJv'-la(igta|^- |ifi:^irjjnnit'i>a]iJ jJi'Uft.'od n'lffN, tiK.yplfllih 
ifrAlO^ ?iSJtjfcwjcf a intL'qKniJA'for iimk.TjtinJinj( and dcsisninn 



i^pdc Utrapulcr, Inc. 

.^nl^.^UiiiiiiAiuu; 



■irrrtaiiOJilmiiiWnn 

n.\n-rp Pni*ijniii^A. 



